ActiveDirectoryAuthenticationProvider 建構函式

定義

命名空間:

Microsoft.Data.SqlClient

組件:

Microsoft.Data.SqlClient.Extensions.Azure.dll

套件:

Microsoft.Data.SqlClient.Extensions.Azure v7.1.0

多載

名稱	Description
ActiveDirectoryAuthenticationProvider()	初始化 ActiveDirectoryAuthenticationProvider 類別。
ActiveDirectoryAuthenticationProvider(ActiveDirectoryAuthenticationProviderOptions)	從ActiveDirectoryAuthenticationProviderOptions袋子中初始化類別ActiveDirectoryAuthenticationProvider。 這是新程式碼的推薦建構器，因為可以新增 ActiveDirectoryAuthenticationProviderOptions 選項而不強制呼叫者做出破壞性的變更。
ActiveDirectoryAuthenticationProvider(String)	以提供的應用程式用戶端 ID 初始化類別 ActiveDirectoryAuthenticationProvider 。
ActiveDirectoryAuthenticationProvider(Func<DeviceCodeResult,Task>, String)	以提供的裝置程式碼流程回調方法及應用程式用戶端 ID 初始化類別 ActiveDirectoryAuthenticationProvider 。

ActiveDirectoryAuthenticationProvider()

初始化 ActiveDirectoryAuthenticationProvider 類別。

public:
 ActiveDirectoryAuthenticationProvider();

public ActiveDirectoryAuthenticationProvider();

Public Sub New ()

備註

新程式碼應偏好超載， ActiveDirectoryAuthenticationProvider(ActiveDirectoryAuthenticationProviderOptions) 以避免在新選項引入時增加更多建構子過載。

ActiveDirectoryAuthenticationProvider(ActiveDirectoryAuthenticationProviderOptions)

從ActiveDirectoryAuthenticationProviderOptions袋子中初始化類別ActiveDirectoryAuthenticationProvider。 這是新程式碼的推薦建構器，因為可以新增 ActiveDirectoryAuthenticationProviderOptions 選項而不強制呼叫者做出破壞性的變更。

public:
 ActiveDirectoryAuthenticationProvider(Microsoft::Data::SqlClient::ActiveDirectoryAuthenticationProviderOptions ^ options);

public ActiveDirectoryAuthenticationProvider(Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProviderOptions options);

new Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider : Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProviderOptions -> Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider

Public Sub New (options As ActiveDirectoryAuthenticationProviderOptions)

參數

options

ActiveDirectoryAuthenticationProviderOptions

一個 ActiveDirectoryAuthenticationProviderOptions 屬性會初始化提供者的實例。 必須不是 null。

例外狀況

ArgumentNullException

當 是 options時拋出 null 。

ActiveDirectoryAuthenticationProvider(String)

以提供的應用程式用戶端 ID 初始化類別 ActiveDirectoryAuthenticationProvider 。

public:
 ActiveDirectoryAuthenticationProvider(System::String ^ applicationClientId);

public ActiveDirectoryAuthenticationProvider(string applicationClientId);

new Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider : string -> Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider

Public Sub New (applicationClientId As String)

參數

applicationClientId

String

用戶端應用程式識別碼用於取得聯邦認證的存取權杖。 驅動程式預設使用自己的應用程式客戶端 ID。

範例

以下範例示範如何為 SqlClient 提供使用者定義的應用程式用戶端 ID 以配合「Active Directory Interactive」認證方法：

using System;
using Microsoft.Data.SqlClient;

namespace CustomAuthenticationProviderExamples
{
  public class Program
  {
    public static void Main()
    {
      // Supported for all authentication modes supported by ActiveDirectoryAuthenticationProvider
      ActiveDirectoryAuthenticationProvider provider = new ActiveDirectoryAuthenticationProvider("<application_client_id>");
      if (provider.IsSupported(SqlAuthenticationMethod.ActiveDirectoryInteractive))
      {
        SqlAuthenticationProvider.SetProvider(SqlAuthenticationMethod.ActiveDirectoryInteractive, provider);
      }

      using (SqlConnection sqlConnection = new SqlConnection("Server=<myserver>.database.windows.net;Authentication=Active Directory Interactive;Database=>db<;"))
      {
        sqlConnection.Open();
        Console.WriteLine("Connected successfully!");
      }
    }
  }
}

備註

新程式碼應偏好超載， ActiveDirectoryAuthenticationProvider(ActiveDirectoryAuthenticationProviderOptions) 以避免在新選項引入時增加更多建構子過載。

ActiveDirectoryAuthenticationProvider(Func<DeviceCodeResult,Task>, String)

以提供的裝置程式碼流程回調方法及應用程式用戶端 ID 初始化類別 ActiveDirectoryAuthenticationProvider 。

public ActiveDirectoryAuthenticationProvider(Func<Microsoft.Identity.Client.DeviceCodeResult,System.Threading.Tasks.Task> deviceCodeFlowCallbackMethod, string? applicationClientId = default);

new Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider : Func<Microsoft.Identity.Client.DeviceCodeResult, System.Threading.Tasks.Task> * string -> Microsoft.Data.SqlClient.ActiveDirectoryAuthenticationProvider

Public Sub New (deviceCodeFlowCallbackMethod As Func(Of DeviceCodeResult, Task), Optional applicationClientId As String = Nothing)

參數

deviceCodeFlowCallbackMethod

Func<DeviceCodeResult,Task>

回調方法用於「Active Directory 裝置程式碼流程」認證。

applicationClientId

String

（可選）用戶端應用程式識別碼用於取得聯邦認證的存取權杖。 驅動程式預設使用自己的應用程式客戶端 ID。

備註

新程式碼應偏好超載， ActiveDirectoryAuthenticationProvider(ActiveDirectoryAuthenticationProviderOptions) 以避免在新選項引入時增加更多建構子過載。