SqlConnectionStringBuilder.Values Property

Reference

Definition

Namespace:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblies:: netstandard.dll, System.Data.SqlClient.dll

Package:: System.Data.SqlClient v4.8.6

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 an ICollection that contains the values in the SqlConnectionStringBuilder.

public:
 virtual property System::Collections::ICollection ^ Values { System::Collections::ICollection ^ get(); };

public override System.Collections.ICollection Values { get; }

member this.Values : System.Collections.ICollection

Public Overrides ReadOnly Property Values As ICollection

Property Value

ICollection

An ICollection that contains the values in the SqlConnectionStringBuilder.

Examples

The following example first creates a new SqlConnectionStringBuilder, and then iterates through all the values within the object.

using System.Data.SqlClient;

class Program
{
    static void Main()
    {
        SqlConnectionStringBuilder builder =
            new SqlConnectionStringBuilder(GetConnectionString());

        // Loop through each of the values, displaying the contents.
        foreach (object value in builder.Values)
            Console.WriteLine(value);

        Console.WriteLine("Press any key 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=SSPI;" +
            "Initial Catalog=AdventureWorks; Asynchronous Processing=true";
    }
}

Imports System.Data.SqlClient
    
Module Module1
    Sub Main()
        Dim builder As _
         New SqlConnectionStringBuilder(GetConnectionString())

        ' Loop through each of the values, displaying the contents.
        For Each value As Object In builder.Values
            Console.WriteLine(value)
        Next

        Console.WriteLine("Press any key to continue.")
        Console.ReadLine()
    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; Asynchronous Processing=True"
    End Function
End Module

Remarks

The order of the values in the ICollection is unspecified, but it is the same order as the associated keys in the ICollection returned by the Keys property. Because each instance of the SqlConnectionStringBuilder always contains the same fixed set of keys, the Values property always returns the values corresponding to the fixed set of keys, in the same order as the keys.

Applies to

Dela via