commit translated contents

includes/migration-guide/retargeting/asp/aspnet-accessibility-improvements-net-framework-471.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET Framework 4.7.1 以降、ASP.NET のお客様のサポートを改善する目的で、ASP.NET Web コントロールによる Visual Studio のアクセシビリティ テクノロジの処理方法が向上しています。  この機能強化には次の変更内容が含まれています。<ul><li>[詳細の表示] ウィザードの [フィールドの追加] ダイアログや ListView ウィザードの [ListView の構成] ダイアログなど、コントロールで不足していた UI アクセシビリティ パターンを実装するための変更。</li><li>データ ページャー フィールド エディターなど、ハイ コントラスト モードでの表示を改善するための変更。</li><li>DataPager コントロールの [ページャーのフィールドを編集] ウィザードの [フィールド] ダイアログ、[ObjectContext の構成] ダイアログ、[データ ソースの構成] ウィザードの [Configure Data Selction]\(データの選択の構成\) ダイアログなど、キーボードの操作性を改善するための変更。</li></ul>|
+|詳細|.NET Framework 4.7.1 以降、ASP.NET のお客様のサポートを改善する目的で、ASP.NET Web コントロールによる Visual Studio のアクセシビリティ テクノロジの処理方法が向上しています。  この機能強化には次の変更内容が含まれています。<ul><li>[詳細の表示] ウィザードの [フィールドの追加] ダイアログや ListView ウィザードの [ListView の構成] ダイアログなど、コントロールで不足していた UI アクセシビリティ パターンを実装するための変更。</li><li>データ ページャー フィールド エディターなど、ハイ コントラスト モードでの表示を改善するための変更。</li><li>DataPager コントロールの [ページャーのフィールドを編集] ウィザードの [フィールド] ダイアログ、[ObjectContext の構成] ダイアログ、[データ ソースの構成] ウィザードの [Configure Data Selction]\(データの選択の構成\) ダイアログなど、キーボードの操作性を改善するための変更。</li></ul>|
 |提案される解決策|<strong>以上の変更を選択する方法と選択しない方法</strong>Visual Studio デザイナーの場合、.NET Framework 4.7.1 以降で実行しなければ、以上の変更から何の改善も得られません。 Web アプリケーションの場合、次のいずれかの手法をとることで、以上の変更によって機能が強化されます。<ul><li>Visual Studio 2017 15.3 以降をインストールする。このバージョンからは既定で、次の項目にある AppContext スイッチで新しいアクセシビリティ機能に対応しています。</li><li>下の例のように、devenv.exe.config ファイルの <code>&lt;runtime&gt;</code> セクションに <code>Switch.UseLegacyAccessibilityFeatures</code> AppContext スイッチを追加し、それを <code>false</code> に設定することで、以前のアクセシビリティ動作を無効にする。</li></ul><pre><code class="lang-xml">&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;&#13;&#10;&lt;configuration&gt;&#13;&#10;&lt;runtime&gt;&#13;&#10;...&#13;&#10;&lt;!-- AppContextSwitchOverrides value attribute is in the form of &#39;key1=true/false;key2=true/false&#39;  --&gt;&#13;&#10;&lt;AppContextSwitchOverrides value=&quot;Switch.UseLegacyAccessibilityFeatures=false&quot; /&gt;&#13;&#10;...&#13;&#10;&lt;/runtime&gt;&#13;&#10;&lt;/configuration&gt;&#13;&#10;</code></pre>.NET Framework 4.7.1 以降を対象とするアプリケーションで以前のアクセシビリティ動作を残す場合、この AppContext スイッチを明示的に <code>true</code> に設定することで以前のアクセシビリティ機能を選択できます。|
 |スコープ|マイナー|
 |Version|4.7.1|

includes/migration-guide/retargeting/ef/building-an-entity-framework-edmx-with-visual-studio-2013-can-fail-error.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|MSBuild 12.0 ツール (Visual Studio 2013 に含まれる) は、MSBuild ファイルの位置を変更したため、古い Entity Framework のターゲット ファイルは無効になります。 その結果、<code>EntityDeploySplit</code> および <code>EntityClean</code> タスクは、<code>Microsoft.Data.Entity.Build.Tasks.dll</code> を見つけられないために失敗します。 このエラーは、ツールセット (MSBuild/VS) の変更によるものであり、.NET Framework の変更によるものではないことに注意してください。 開発者ツールをアップグレードしたときにのみ発生し、.NET Framework をアップグレード下だけでは発生しません。|
+|詳細|MSBuild 12.0 ツール (Visual Studio 2013 に含まれる) は、MSBuild ファイルの位置を変更したため、古い Entity Framework のターゲット ファイルは無効になります。 その結果、<code>EntityDeploySplit</code> および <code>EntityClean</code> タスクは、<code>Microsoft.Data.Entity.Build.Tasks.dll</code> を見つけられないために失敗します。 このエラーは、ツールセット (MSBuild/VS) の変更によるものであり、.NET Framework の変更によるものではないことに注意してください。 開発者ツールをアップグレードしたときにのみ発生し、.NET Framework をアップグレード下だけでは発生しません。|
 |提案される解決策|Entity Framework のターゲット ファイルは、.NET Framework 4.6 以降の新しい MSBuild レイアウトで機能するように修正されます。 このバージョンの Framework にアップグレードすることで、この問題は修正されます。 または、[この](http://stackoverflow.com/a/24249247/131944) 回避策を使用して、ターゲット ファイルに直接パッチを当てることができます。|
 |スコープ|Major|
 |Version|4.5.1|

includes/migration-guide/retargeting/networking/sslstream-supports-tls-alerts.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|TLS ハンドシェイクに失敗すると、最初の I/O 読み取り/書き込み操作によって <xref:System.IO.IOException?displayProperty=name> と内部例外 <xref:System.ComponentModel.Win32Exception?displayProperty=name> がスローされます。 <xref:System.ComponentModel.Win32Exception?displayProperty=name> の <xref:System.ComponentModel.Win32Exception.NativeErrorCode?displayProperty=name> コードは、この [Schannel ドキュメント](https://msdn.microsoft.com/library/windows/desktop/dd721886%28v=vs.85%29.aspx)を使用してリモート パーティからの TLS アラートにマップすることができます。詳細については、「[RFC 2246: Section 7.2.2 Error alerts](https://tools.ietf.org/html/rfc2246#section-7.2.2)」をご覧ください。 <br/>.NET Framework 4.6.2 およびそれより前のバージョンでの動作では、他のパーティがハンドシェイクに失敗してそのすぐ後に接続を拒否した場合、トランスポート チャネル (通常は TCP 接続) は書き込みまたは読み取り中にタイムアウトします。|
+|詳細|TLS ハンドシェイクに失敗すると、最初の I/O 読み取り/書き込み操作によって <xref:System.IO.IOException?displayProperty=name> と内部例外 <xref:System.ComponentModel.Win32Exception?displayProperty=name> がスローされます。 <xref:System.ComponentModel.Win32Exception?displayProperty=name> の <xref:System.ComponentModel.Win32Exception.NativeErrorCode?displayProperty=name> コードは、この [Schannel ドキュメント](https://msdn.microsoft.com/library/windows/desktop/dd721886%28v=vs.85%29.aspx)を使用してリモート パーティからの TLS アラートにマップすることができます。詳細については、「[RFC 2246: Section 7.2.2 Error alerts](https://tools.ietf.org/html/rfc2246#section-7.2.2)」をご覧ください。 <br/>.NET Framework 4.6.2 およびそれより前のバージョンでの動作では、他のパーティがハンドシェイクに失敗してそのすぐ後に接続を拒否した場合、トランスポート チャネル (通常は TCP 接続) は書き込みまたは読み取り中にタイムアウトします。|
 |提案される解決策|<xref:System.IO.Stream.Read(System.Byte[],System.Int32,System.Int32)>/<xref:System.IO.Stream.Write(System.Byte[],System.Int32,System.Int32)> などのネットワーク I/O API を呼び出すアプリケーションは、<xref:System.IO.IOException> または <xref:System.TimeoutException?displayProperty=name> を処理する必要があります。<br/>TLS アラート機能は、.NET Framework 4.7 以降では既定で有効になります。 .NET Framework 4.7 またはそれより後のシステムで動作する 4.0 から 4.6.2 のバージョンの .NET Framework を対象とするアプリケーションは、互換性を維持するためにこの機能を無効にします。 <br/>.NET Framework 4.7 以降で動作する .NET Framework 4.6 以降のアプリケーションでこの機能を有効または無効にするには、次の構成 API を使います。<ul><li>プログラムによる:</li></ul>ServicePointManager は 1 回のみ初期化するため、アプリケーションで行われる一番最初の動作にする必要があります。<pre><code class="lang-csharp">AppContext.SetSwitch(&quot;TestSwitch.LocalAppContext.DisableCaching&quot;, true);&#13;&#10;AppContext.SetSwitch(&quot;Switch.System.Net.DontEnableTlsAlerts&quot;, true); // Set to &#39;false&#39; to enable the feature in .NET Framework 4.6 - 4.6.2.&#13;&#10;</code></pre><ul><li>AppConfig:</li></ul><pre><code class="lang-xml">&lt;runtime&gt;&#13;&#10;&lt;AppContextSwitchOverrides value=&quot;Switch.System.Net.DontEnableTlsAlerts=true&quot;/&gt;&#13;&#10;&lt;!-- Set to &#39;false&#39; to enable the feature in .NET Framework 4.6 - 4.6.2. --&gt;&#13;&#10;&lt;/runtime&gt;&#13;&#10;</code></pre><ul><li>レジストリ キー (マシン グローバル):</p>.NET Framework 4.6 - 4.6.2 でこの機能を有効にするには、Value を <code>false</code> に設定します。<ul><li>>キー: HKLM\SOFTWARE\Wow6432Node\Microsoft\\.NETFramework\AppContext\Switch.System.Net.DontEnableTlsAlerts</li><li>型: String</li><li>値: &quot;true&quot</li></ul></ul> |
 |スコープ|エッジ|
 |Version|4.7|

includes/migration-guide/retargeting/wcf/serialization-control-characters-with-datacontractjsonserializer-now.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET framework 4.6.2 以前のバージョンでは、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=name> で、ECMAScript V6 および V8 標準と互換性がある方法で \b、\f、\t などの一部の特殊制御文字がシリアル化されませんでした。 .NET Framework 4.7 以降、これらの制御文字のシリアル化は ECMAScript V6 および V8 と互換性があります。|
+|詳細|.NET framework 4.6.2 以前のバージョンでは、<xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=name> で、ECMAScript V6 および V8 標準と互換性がある方法で \b、\f、\t などの一部の特殊制御文字がシリアル化されませんでした。 .NET Framework 4.7 以降、これらの制御文字のシリアル化は ECMAScript V6 および V8 と互換性があります。|
 |提案される解決策|.NET Framework 4.7 を対象とするアプリの場合、この機能は既定で有効になっています。 この動作が望ましくない場合は、app.config または web.config ファイルの <code>&lt;runtime&gt;</code> セクションに次の行を追加して、この機能を無効にすることができます。<pre><code class="lang-xml">&lt;runtime&gt;&#13;&#10;&lt;AppContextSwitchOverrides value=&quot;Switch.System.Runtime.Serialization.DoNotUseECMAScriptV6EscapeControlCharacter=false&quot; /&gt;&#13;&#10;&lt;/runtime&gt;&#13;&#10;</code></pre>|
 |スコープ|エッジ|
 |Version|4.7|

includes/migration-guide/runtime/adonet/adonet-now-attempts-automatically-reconnect-broken-sql-connections.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET Framework 4.5.1 以降、.NET Framework では、切断された SQL 接続の再接続が自動的に試行されます。 通常、これはアプリの安定性を高めますが、再接続時に行動できるよう、接続が失われたことをアプリに認識させる必要があるという極端な状況があります。|
+|詳細|.NET Framework 4.5.1 以降、.NET Framework では、切断された SQL 接続の再接続が自動的に試行されます。 通常、これはアプリの安定性を高めますが、再接続時に行動できるよう、接続が失われたことをアプリに認識させる必要があるという極端な状況があります。|
 |提案される解決策|互換性の問題からこの機能が望ましくない場合、接続文字列 (または <xref:System.Data.SqlClient.SqlConnectionStringBuilder?displayProperty=name>) の <xref:System.Data.SqlClient.SqlConnectionStringBuilder.ConnectRetryCount?displayProperty=name> プロパティを 0 に設定することで無効にできます。|
 |スコープ|エッジ|
 |Version|4.5.1|

includes/migration-guide/runtime/core/systemuri-escaping-now-supports-rfc-3986.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|URI エスケープは、.NET Framework 4.5 で、[RFC 3986](http://tools.ietf.org/html/rfc3986) をサポートするように変更されました。 具体的な変更内容:<ul><li><xref:System.Uri.EscapeDataString(System.String)?displayProperty=name> は、予約されている文字を RFC 3986 に基づいてエスケープします。</li><li><xref:System.Uri.EscapeUriString(System.String)?displayProperty=name> は、予約されている文字をエスケープしません。</li><li><xref:System.Uri.UnescapeDataString(System.String)?displayProperty=name> は、無効なエスケープ シーケンスが発生した場合に例外をスローしません。</li><li>予約されていないエスケープ文字はエスケープ解除されます。</li></ul>|
+|詳細|URI エスケープは、.NET Framework 4.5 で、[RFC 3986](http://tools.ietf.org/html/rfc3986) をサポートするように変更されました。 具体的な変更内容:<ul><li><xref:System.Uri.EscapeDataString(System.String)?displayProperty=name> は、予約されている文字を RFC 3986 に基づいてエスケープします。</li><li><xref:System.Uri.EscapeUriString(System.String)?displayProperty=name> は、予約されている文字をエスケープしません。</li><li><xref:System.Uri.UnescapeDataString(System.String)?displayProperty=name> は、無効なエスケープ シーケンスが発生した場合に例外をスローしません。</li><li>予約されていないエスケープ文字はエスケープ解除されます。</li></ul>|
 |提案される解決策|<ul><li>無効なエスケープ シーケンスの場合、<xref:System.Uri.UnescapeDataString(System.String)?displayProperty=name> のスローに依存しないように、アプリケーションを更新します。 このようなシーケンスは、直接削除する必要があります。</li><li>同様に、エスケープおよびエスケープ解除された URI とデータ文字列は、.NET Framework 4.0 と .NET Framework 4.5 で異なる場合があるため、.NET のバージョン間で直接比較しないでください。 代わりに、1 つの .NET バージョンで解析と正規化を行ってから比較してください。</li></ul>|
 |スコープ|マイナー|
 |Version|4.5|

includes/migration-guide/runtime/security/rsacngverifyhash-now-returns-false-for-any-verification-failure.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET Framework 4.6.2 以降では、署名自体の形式が正しくない場合、このメソッドでは <strong>False</strong> が返されます。 今すぐ false を返しますの検証に失敗しました。 .NET Framework 4.6 および 4.6.1 では、メソッドによってスローされる、<xref:System.Security.Cryptography.CryptographicException?displayProperty=name>署名自体が正しくフォーマットされている場合。|
+|詳細|.NET Framework 4.6.2 以降では、署名自体の形式が正しくない場合、このメソッドでは <strong>False</strong> が返されます。 今すぐ false を返しますの検証に失敗しました。 .NET Framework 4.6 および 4.6.1 では、メソッドによってスローされる、<xref:System.Security.Cryptography.CryptographicException?displayProperty=name>署名自体が正しくフォーマットされている場合。|
 |提案される解決策|検証が失敗し、メソッドで <strong>False</strong> が返される場合は、代わりにその実行が <xref:System.Security.Cryptography.CryptographicException?displayProperty=name> の処理に依存するコードが実行される必要があります。|
 |スコープ|マイナー|
 |Version|4.6.2|

includes/migration-guide/runtime/serialization/exception-message-has-changed-for-failed-datacontract-serialization-case-an.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET Framework 4.6 以降では、"既知の型" がないために <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=name> または <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=name> のシリアル化または逆シリアル化が失敗した場合に提供される例外メッセージが明確化されました。|
+|詳細|.NET Framework 4.6 以降では、"既知の型" がないために <xref:System.Runtime.Serialization.DataContractSerializer?displayProperty=name> または <xref:System.Runtime.Serialization.Json.DataContractJsonSerializer?displayProperty=name> のシリアル化または逆シリアル化が失敗した場合に提供される例外メッセージが明確化されました。|
 |提案される解決策|アプリは、特定の例外メッセージに依存しないようにする必要があります。 アプリがこのメッセージに依存している場合は、新しいメッセージを使うように更新するか、(可能であれば) 例外の種類のみに依存するように変更します。|
 |スコープ|エッジ|
 |Version|4.6|

includes/migration-guide/runtime/wcf/wcf-pipeconnectiongethashalgorithm-now-uses-sha256.md

@@ -2,7 +2,7 @@
 
 |   |   |
 |---|---|
-|説明|.NET Framework 4.7.1 以降の Windows Communication Foundation は、SHA256 ハッシュを使用して名前付きパイプ用のランダムな名前を生成します。 .NET Framework 4.7 以前のバージョンでは、SHA1 ハッシュを使っていました。|
+|詳細|.NET Framework 4.7.1 以降の Windows Communication Foundation は、SHA256 ハッシュを使用して名前付きパイプ用のランダムな名前を生成します。 .NET Framework 4.7 以前のバージョンでは、SHA1 ハッシュを使っていました。|
 |提案される解決策|.NET Framework 4.7.1 以降でこの変更に関する互換性の問題が発生した場合は、次の行を app.config ファイルの <code>&lt;runtime&gt;</code> セクションに追加することで、変更を無効にできます。<pre><code class="lang-xml">&lt;configuration&gt;&#13;&#10;&lt;runtime&gt;&#13;&#10;&lt;AppContextSwitchOverrides value=&quot;Switch.System.ServiceModel.UseSha1InPipeConnectionGetHashAlgorithm=true&quot; /&gt;&#13;&#10;&lt;/runtime&gt;&#13;&#10;&lt;/configuration&gt;&#13;&#10;</code></pre>|
 |スコープ|マイナー|
 |Version|4.7.1|