SqlConnection.ServerVersion Property

Reference

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Package:: System.Data.SqlClient v4.9.0

Source:: System.Data.SqlClient.notsupported.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a string that contains the version of the instance of SQL Server to which the client is connected.

public:
 virtual property System::String ^ ServerVersion { System::String ^ get(); };

public:
 property System::String ^ ServerVersion { System::String ^ get(); };

public override string ServerVersion { get; }

[System.ComponentModel.Browsable(false)]
[System.Data.DataSysDescription("SqlConnection_ServerVersion")]
public string ServerVersion { get; }

[System.ComponentModel.Browsable(false)]
public override string ServerVersion { get; }

member this.ServerVersion : string

[<System.ComponentModel.Browsable(false)>]
[<System.Data.DataSysDescription("SqlConnection_ServerVersion")>]
member this.ServerVersion : string

[<System.ComponentModel.Browsable(false)>]
member this.ServerVersion : string

Public Overrides ReadOnly Property ServerVersion As String

Public ReadOnly Property ServerVersion As String

Property Value

String

The version of the instance of SQL Server.

Attributes: BrowsableAttribute DataSysDescriptionAttribute

Exceptions

InvalidOperationException

The connection is closed.

ServerVersion was called while the returned Task was not completed and the connection was not opened after a call to OpenAsync(CancellationToken).

Examples

The following example creates a SqlConnection and displays the ServerVersion property.

private static void CreateSqlConnection(string connectionString)
{
    using (SqlConnection connection = new SqlConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
        Console.WriteLine("State: {0}", connection.State );
    }
}

 Private Sub CreateSqlConnection(ByVal connectionString As String)
     Using connection As New SqlConnection(connectionString)
         connection.Open()
         Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
         Console.WriteLine("State: {0}", connection.State)
     End Using
End Sub

Remarks

The version is of the form ##.##.####, where the first two digits are the major version, the next two digits are the minor version, and the last four digits are the release version. The string is of the form major.minor.build, where major and minor are exactly two digits and build is exactly four digits.

ServerVersion was called while the returned Task was not completed and the connection was not opened after a call to OpenAsync.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, 6 (package-provided), 7 (package-provided), 8 (package-provided), 9 (package-provided), 10 (package-provided)
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0 (package-provided)

Share via