Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<summary>The implementation of the key store provider for Windows Certificate Store. This class enables using certificates stored in the Windows Certificate Store as column master keys. For details, see <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
<remarks>To be added.</remarks>
<related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -66,7 +66,7 @@
<param name="encryptionAlgorithm">The encryption algorithm. Currently, the only valid value is: <c>RSA_OAEP</c>.</param>
<param name="encryptedColumnEncryptionKey">The encrypted column encryption key.</param>
<summary>Decrypts the specified encrypted value of a column encryption key. The encrypted value is expected to be encrypted using the certificate with the specified key path and using the specified algorithm. The format of the key path should be "Local Machine/My/&lt;certificate_thumbprint&gt;" or "Current User/My/&lt;certificate_thumbprint&gt;".</summary>
<returns>Returns <see cref="T:System.Byte" />.
<returns>Returns <see cref="T:System.Byte" />.
The decrypted column encryption key.</returns>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -96,7 +96,7 @@ The decrypted column encryption key.</returns>
<param name="encryptionAlgorithm">The encryption algorithm. Currently, the only valid value is: <c>RSA_OAEP</c>.</param>
<param name="columnEncryptionKey">The encrypted column encryption key.</param>
<summary>Encrypts a column encryption key using the certificate with the specified key path and using the specified algorithm. The format of the key path should be "Local Machine/My/&lt;certificate_thumbprint&gt;" or "Current User/My/&lt;certificate_thumbprint&gt;".</summary>
<returns>Returns <see cref="T:System.Byte" />.
<returns>Returns <see cref="T:System.Byte" />.
The encrypted column encryption key.</returns>
<remarks>To be added.</remarks>
</Docs>
Expand Down
22 changes: 11 additions & 11 deletions xml/System.Data.SqlClient/SqlColumnEncryptionCngProvider.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@
<Docs>
<summary>The CMK Store provider implementation for using the Microsoft Cryptography API: Next Generation (CNG) with <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Enables storing Always Encrypted column master key keys in a store, such as a hardware security module (HSM), that supports the Microsoft Cryptography API: Next Generation (CNG).
<format type="text/markdown"><![CDATA[

## Remarks
Enables storing Always Encrypted column master key keys in a store, such as a hardware security module (HSM), that supports the Microsoft Cryptography API: Next Generation (CNG).

]]></format>
</remarks>
<related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -148,11 +148,11 @@
<summary>Throws a <see cref="T:System.NotSupportedException" /> exception in all cases.</summary>
<returns>The signature of the column master key metadata.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The <xref:System.Data.SqlClient.SqlColumnEncryptionCngProvider.SignColumnMasterKeyMetadata%2A> method must be implemented by the corresponding key store providers. <xref:System.Data.SqlClient.SqlColumnEncryptionCngProvider.SignColumnMasterKeyMetadata%2A> should use an asymmetric key identified by a key path and sign the masterkey metadata consisting of `masterKeyPath`, `allowEnclaveComputations`, and providerName.
<format type="text/markdown"><![CDATA[

## Remarks
The <xref:System.Data.SqlClient.SqlColumnEncryptionCngProvider.SignColumnMasterKeyMetadata%2A> method must be implemented by the corresponding key store providers. <xref:System.Data.SqlClient.SqlColumnEncryptionCngProvider.SignColumnMasterKeyMetadata%2A> should use an asymmetric key identified by a key path and sign the masterkey metadata consisting of `masterKeyPath`, `allowEnclaveComputations`, and providerName.

]]></format>
</remarks>
<exception cref="T:System.NotSupportedException">In all cases.</exception>
Expand Down
22 changes: 11 additions & 11 deletions xml/System.Data.SqlClient/SqlColumnEncryptionCspProvider.xml
Original file line number Diff line number Diff line change
Expand Up @@ -16,15 +16,15 @@
<Docs>
<summary>The CMK Store provider implementation for using Microsoft CAPI based Cryptographic Service Providers (CSP) with <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
Enables storing Always Encrypted column master key keys in a store, such as a hardware security module (HSM), that supports the Microsoft CAPI based Cryptographic Service Providers (CSP).
<format type="text/markdown"><![CDATA[

## Remarks
Enables storing Always Encrypted column master key keys in a store, such as a hardware security module (HSM), that supports the Microsoft CAPI based Cryptographic Service Providers (CSP).

]]></format>
</remarks>
<related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -148,11 +148,11 @@
<summary>Throws a <see cref="T:System.NotSupportedException" /> exception in all cases.</summary>
<returns>The signature of the column master key metadata.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
The <xref:System.Data.SqlClient.SqlColumnEncryptionCspProvider.SignColumnMasterKeyMetadata%2A> method must be implemented by the corresponding key store providers. <xref:System.Data.SqlClient.SqlColumnEncryptionCspProvider.SignColumnMasterKeyMetadata%2A> should use an asymmetric key identified by a key path and sign the masterkey metadata consisting of `masterKeyPath`, `allowEnclaveComputations`, and providerName.
<format type="text/markdown"><![CDATA[

## Remarks
The <xref:System.Data.SqlClient.SqlColumnEncryptionCspProvider.SignColumnMasterKeyMetadata%2A> method must be implemented by the corresponding key store providers. <xref:System.Data.SqlClient.SqlColumnEncryptionCspProvider.SignColumnMasterKeyMetadata%2A> should use an asymmetric key identified by a key path and sign the masterkey metadata consisting of `masterKeyPath`, `allowEnclaveComputations`, and providerName.

]]></format>
</remarks>
<exception cref="T:System.NotSupportedException">In all cases.</exception>
Expand Down
20 changes: 10 additions & 10 deletions xml/System.Data.SqlClient/SqlColumnEncryptionKeyStoreProvider.xml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
<summary>Base class for all key store providers. A custom provider must derive from this class and override its member functions and then register it using SqlConnection.RegisterColumnEncryptionKeyStoreProviders(). For details see, <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted</see>.</summary>
<remarks>To be added.</remarks>
<related type="ExternalDocumentation" href="https://techcommunity.microsoft.com/t5/sql-server/getting-started-with-always-encrypted/ba-p/384397">Get started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Develop apps using Always Encrypted</related>
</Docs>
<Members>
<Member MemberName=".ctor">
Expand Down Expand Up @@ -62,7 +62,7 @@
<param name="encryptionAlgorithm">The encryption algorithm.</param>
<param name="encryptedColumnEncryptionKey">The encrypted column encryption key.</param>
<summary>Decrypts the specified encrypted value of a column encryption key. The encrypted value is expected to be encrypted using the column master key with the specified key path and using the specified algorithm.</summary>
<returns>Returns <see cref="T:System.Byte" />.
<returns>Returns <see cref="T:System.Byte" />.
The decrypted column encryption key.</returns>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -92,7 +92,7 @@ The decrypted column encryption key.</returns>
<param name="encryptionAlgorithm">The encryption algorithm.</param>
<param name="columnEncryptionKey">The encrypted column encryption key.</param>
<summary>Encrypts a column encryption key using the column master key with the specified key path and using the specified algorithm.</summary>
<returns>Returns <see cref="T:System.Byte" />.
<returns>Returns <see cref="T:System.Byte" />.
The encrypted column encryption key.</returns>
<remarks>To be added.</remarks>
</Docs>
Expand Down Expand Up @@ -123,13 +123,13 @@ The encrypted column encryption key.</returns>
<summary>When implemented in a derived class, digitally signs the column master key metadata with the column master key referenced by the <paramref name="masterKeyPath" /> parameter. The input values used to generate the signature should be the specified values of the <paramref name="masterKeyPath" /> and <paramref name="allowEnclaveComputations" /> parameters.</summary>
<returns>The signature of the column master key metadata.</returns>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
To ensure that the <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> method doesn't break applications that rely on an old API, it throws a <xref:System.NotImplementedException> exception by default.
The <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> method will be used by client tools that generate Column Master Keys (CMK) for customers. <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> must be implemented by the corresponding key store providers that wish to use enclaves with [Always Encrypted](https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine).
<format type="text/markdown"><![CDATA[

## Remarks
To ensure that the <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> method doesn't break applications that rely on an old API, it throws a <xref:System.NotImplementedException> exception by default.

The <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> method will be used by client tools that generate Column Master Keys (CMK) for customers. <xref:System.Data.SqlClient.SqlColumnEncryptionKeyStoreProvider.SignColumnMasterKeyMetadata%2A> must be implemented by the corresponding key store providers that wish to use enclaves with [Always Encrypted](https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine).

]]></format>
</remarks>
<exception cref="T:System.NotImplementedException">In all cases.</exception>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,18 +16,18 @@
<Docs>
<summary>Specifies how data will be sent and received when reading and writing encrypted columns. Depending on your specific query, performance impact may be reduced by bypassing the Always Encrypted driver's processing when non-encrypted columns are being used. Note that these settings cannot be used to bypass encryption and gain access to plaintext data. For details, see <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted (Database Engine)</see>.</summary>
<remarks>
<format type="text/markdown"><![CDATA[
## Remarks
- If Always Encrypted is disabled for a query and the query has parameters that need to be encrypted (parameters that correspond to encrypted columns), the query will fail.
- If Always Encrypted is disabled for a query and the query returns results from encrypted columns, the query will return encrypted values. The encrypted values will have the varbinary datatype.
<format type="text/markdown"><![CDATA[

## Remarks

- If Always Encrypted is disabled for a query and the query has parameters that need to be encrypted (parameters that correspond to encrypted columns), the query will fail.

- If Always Encrypted is disabled for a query and the query returns results from encrypted columns, the query will return encrypted values. The encrypted values will have the varbinary datatype.

]]></format>
</remarks>
<related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/2015/06/04/getting-started-with-always-encrypted/">Getting Started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
</Docs>
<Members>
<Member MemberName="Disabled">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
<summary>Specifies that Always Encrypted functionality is enabled in a connection. Note that these settings cannot be used to bypass encryption and gain access to plaintext data. For details, see <see href="https://learn.microsoft.com/sql/relational-databases/security/encryption/always-encrypted-database-engine">Always Encrypted (Database Engine)</see>.</summary>
<remarks>To be added.</remarks>
<related type="ExternalDocumentation" href="https://blogs.msdn.microsoft.com/sqlsecurity/2015/06/04/getting-started-with-always-encrypted/">Getting Started with Always Encrypted (blog post)</related>
<related type="ExternalDocumentation" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
<related type="Article" href="/sql/relational-databases/security/encryption/always-encrypted-client-development">Always Encrypted (client development)</related>
</Docs>
<Members>
<Member MemberName="Disabled">
Expand Down
8 changes: 4 additions & 4 deletions xml/System.Data/DataTable.xml
Original file line number Diff line number Diff line change
Expand Up @@ -6046,7 +6046,7 @@ public class A {
</remarks>
<altmember cref="P:System.Data.DataTable.CaseSensitive" />
<related type="Article" href="/dotnet/framework/data/adonet/dataset-datatable-dataview/datatables">DataTables</related>
<related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=191549">Null Values</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/sql/sql-server-2008-r2/ms191504(v=sql.105)">Null Values</related>
</Docs>
</Member>
<Member MemberName="Select">
Expand Down Expand Up @@ -6124,7 +6124,7 @@ To ensure the proper sort order, specify sort criteria with <xref:System.Data.Da
</remarks>
<altmember cref="P:System.Data.DataTable.CaseSensitive" />
<related type="Article" href="/dotnet/framework/data/adonet/dataset-datatable-dataview/datatables">DataTables</related>
<related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=191549">Null Values</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/sql/sql-server-2008-r2/ms191504(v=sql.105)">Null Values</related>
</Docs>
</Member>
<Member MemberName="Select">
Expand Down Expand Up @@ -6195,7 +6195,7 @@ To ensure the proper sort order, specify sort criteria with <xref:System.Data.Da
</remarks>
<altmember cref="P:System.Data.DataTable.CaseSensitive" />
<related type="Article" href="/dotnet/framework/data/adonet/dataset-datatable-dataview/datatables">DataTables</related>
<related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=191549">Null Values</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/sql/sql-server-2008-r2/ms191504(v=sql.105)">Null Values</related>
</Docs>
</Member>
<Member MemberName="Select">
Expand Down Expand Up @@ -6267,7 +6267,7 @@ To ensure the proper sort order, specify sort criteria with <xref:System.Data.Da
]]></format>
</remarks>
<related type="Article" href="/dotnet/framework/data/adonet/dataset-datatable-dataview/datatables">DataTables</related>
<related type="ExternalDocumentation" href="https://go.microsoft.com/fwlink/?LinkID=191549">Null Values</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/sql/sql-server-2008-r2/ms191504(v=sql.105)">Null Values</related>
</Docs>
</Member>
<Member MemberName="Site">
Expand Down
8 changes: 4 additions & 4 deletions xml/System.Diagnostics.Eventing.Reader/EventLogSession.xml
Original file line number Diff line number Diff line change
Expand Up @@ -592,8 +592,8 @@

]]></format>
</remarks>
<related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/bb671205.aspx">Technology Summary for Reading and Managing Event Logs</related>
<related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/bb671204.aspx">Event Log Scenarios</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/bb671205(v=vs.90)">Technology Summary for Reading and Managing Event Logs</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/bb671204(v=vs.90)">Event Log Scenarios</related>
</Docs>
</Member>
<Member MemberName="ExportLogAndMessages">
Expand Down Expand Up @@ -647,8 +647,8 @@

]]></format>
</remarks>
<related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/bb671205.aspx">Technology Summary for Reading and Managing Event Logs</related>
<related type="ExternalDocumentation" href="https://msdn.microsoft.com/library/bb671204.aspx">Event Log Scenarios</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/bb671205(v=vs.90)">Technology Summary for Reading and Managing Event Logs</related>
<related type="Article" href="https://learn.microsoft.com/previous-versions/bb671204(v=vs.90)">Event Log Scenarios</related>
</Docs>
</Member>
<Member MemberName="GetLogInformation">
Expand Down
Loading
Loading