Klasa AdomdConnection

Reprezentuje połączenie z danymi wielowymiarowymi źródło.

Hierarchia dziedziczenia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.AnalysisServices.AdomdClient.AdomdConnection

Przestrzeń nazw:  Microsoft.AnalysisServices.AdomdClient
Zestaw:  Microsoft.AnalysisServices.AdomdClient (w Microsoft.AnalysisServices.AdomdClient.dll)

Składnia

'Deklaracja
Public NotInheritable Class AdomdConnection _
    Inherits Component _
    Implements IDbConnection, IDisposable, ICloneable
'Użycie
Dim instance As AdomdConnection

public sealed class AdomdConnection : Component, 
    IDbConnection, IDisposable, ICloneable

public ref class AdomdConnection sealed : public Component, 
    IDbConnection, IDisposable, ICloneable

[<SealedAttribute>]
type AdomdConnection =  
    class
        inherit Component
        interface IDbConnection
        interface IDisposable
        interface ICloneable
    end

public final class AdomdConnection extends Component implements IDbConnection, IDisposable, ICloneable

Typ AdomdConnection uwidacznia następujące elementy członkowskie.

Konstruktorzy

	Nazwa	Opis
	AdomdConnection()	Inicjuje nowe wystąpienie AdomdConnection klasy z wartości domyślnych.
	AdomdConnection(String)	Inicjuje nowe wystąpienie AdomdConnection klasy przy użyciu określonego połączenia ciąg.
	AdomdConnection(AdomdConnection)	Inicjuje nowe wystąpienie AdomdConnection klasy przy użyciu wartości z określonego AdomdConnection klasyIdentyfikator sesja i stan polecenia nie są takie same.

Do góry

Właściwości

	Nazwa	Opis
	CanRaiseEvents	(Dziedziczony z Component).
	ClientVersion	Pobiera wersja ADOMD.NET klient, który implementuje AdomdConnection.
	ConnectionString	Pobiera lub ustawia ciąg , AdomdConnection używa się, aby otworzyć źródło dane analityczne.
	ConnectionTimeout	Pobiera czas oczekiwania na połączenie ustanowione przed AdomdConnection przestanie podejmować próby połączenia i generuje błąd.
	Container	(Dziedziczony z Component).
	Cubes	Pobiera wystąpienie CubeCollection , reprezentuje kolekcja modułów zawartych przez źródło dane analityczne.
	Database	Pobiera nazwę bazy danych do użycia po AdomdConnection jest otwarty.
	DesignMode	(Dziedziczony z Component).
	Events	(Dziedziczony z Component).
	MiningModels	Pobiera wystąpienie MiningModelCollection , reprezentuje kolekcja modeli wyszukiwania, które zawiera źródło dane analityczne.
	MiningServices	Pobiera wystąpienie MiningServiceCollection , reprezentuje kolekcja usług wyszukiwania, które zawiera źródło dane analityczne.
	MiningStructures	Pobiera wystąpienie MiningStructureCollection , reprezentuje kolekcja struktur górnictwa, które zawiera źródło dane analityczne.
	ProviderVersion	Pobiera wersja XML for Analysis dostawca, AdomdConnection zastosowań.
	ServerVersion	Pobiera wersja serwera używany ten AdomdConnection zastosowań.
	SessionID	Pobiera lub ustawia ciąg identyfikatora sesja AdomdConnection z serwera.
	ShowHiddenObjects	Pobiera lub ustawia wartość wskazującą, czy ukryte obiekty są zwracane.
	Site	(Dziedziczony z Component).
	State	Pobiera bieżący stan AdomdConnection.

Do góry

Metody

	Nazwa	Opis
	BeginTransaction()	Rozpoczyna nową transakcję.
	BeginTransaction(IsolationLevel)	Rozpoczyna nową transakcję o określonym IsolationLevel wartość wyliczania.
	ChangeDatabase	Zmiany w bieżącej bazie danych, otwórz AdomdConnection.
	Clone	Tworzy i zwraca wystąpienie AdomdConnection oparte na bieżącym AdomdConnection.Identyfikator sesji i Państwo nie klonowane.
	Close()	Zamyka połączenie z bazą danych i kończy sesja.
	Close(Boolean)	Zamyka połączenie z bazą danych, wskazujący, czy do zakończenia sesja.
	CreateCommand	Tworzy i zwraca AdomdCommand , jest skojarzony z AdomdConnection.
	CreateObjRef	(Dziedziczony z MarshalByRefObject).
	Dispose()	(Dziedziczony z Component).
	Dispose(Boolean)	(Dziedziczony z Component).
	Equals	(Dziedziczony z Object).
	Finalize	(Dziedziczony z Component).
	GetHashCode	(Dziedziczony z Object).
	GetLifetimeService	(Dziedziczony z MarshalByRefObject).
	GetSchemaDataSet(Guid, array<Object[])	Zwraca informacje dotyczące schematu źródło danych przy użyciu Guid obiekt, aby określić, które informacje dotyczące schematu, aby powrócić i stosując wszystkie określone ograniczenia do informacji.
	GetSchemaDataSet(String, AdomdRestrictionCollection)	Zwraca informacje dotyczące schematu źródło danych przy użyciu nazwy schematu do identyfikowania schematu, które pobrać i przy zastosowaniu wszelkich ograniczeń określonych informacji.
	GetSchemaDataSet(Guid, array<Object[], Boolean)	Zwraca informacje dotyczące schematu źródło danych przy użyciu Guid obiekt, aby zidentyfikować informacje stosowania określone ograniczenia informacji i opcjonalnie Zgłaszanie wyjątku, jeśli wystąpią błędy wewnętrzne.
	GetSchemaDataSet(String, AdomdRestrictionCollection, Boolean)	Zwraca informacje o schemacie źródło danych przy użyciu nazwy schematu do identyfikowania informacji, stosowanie wszelkich ograniczeń określonych informacji i opcjonalnie Zgłaszanie wyjątku, jeśli wystąpią błędy wewnętrzne.
	GetSchemaDataSet(String, String, AdomdRestrictionCollection)	Zwraca informacje dotyczące schematu źródło danych przy użyciu nazwy schematu i obszaru nazw do identyfikowania informacji i przy zastosowaniu wszelkich ograniczeń określonych informacji.
	GetSchemaDataSet(String, String, AdomdRestrictionCollection, Boolean)	Zwraca informacje dotyczące schematu źródło danych, informacje przy użyciu nazwy schematu i obszaru nazw, stosowanie wszelkich ograniczeń określonych informacji i, opcjonalnie, jeśli wystąpią błędy wewnętrzne, zgłaszanie wyjątku.
	GetService	(Dziedziczony z Component).
	GetType	(Dziedziczony z Object).
	InitializeLifetimeService	(Dziedziczony z MarshalByRefObject).
	MemberwiseClone()	(Dziedziczony z Object).
	MemberwiseClone(Boolean)	(Dziedziczony z MarshalByRefObject).
	Open()	Otwiera połączenie z danymi analitycznymi źródło przy użyciu ustawień określonych w ConnectionString Właściwość AdomdConnection.
	Open(String)
	RefreshMetadata	Wymusza połączenie ponownie wypełnić wszystkie metadane z serwera.
	ToString	(Dziedziczony z Component).

Do góry

Zdarzenia

	Nazwa	Opis
	Disposed	(Dziedziczony z Component).

Do góry

Jawne implementacje interfejsu

	Nazwa	Opis
	IDbConnection.BeginTransaction()
	IDbConnection.BeginTransaction(IsolationLevel)
	ICloneable.Clone
	IDbConnection.CreateCommand

Do góry

Uwagi

The AdomdConnection represents a connection with an analytical data source (for example, a connection to an instance of Microsoft SQL Server 2005 Analysis Services (SSAS)).Każde połączenie jest skojarzony z XML for Analysis sesja.Jeśli AdomdConnection wykracza poza zakres, połączenie nie zostanie zamknięte.Aby zamknąć połączenia, należy jawnie wywołać Close lub zbywania metoda AdomdConnection.Jeśli Close lub zbywania metoda nie jest wywoływana, sesja skojarzonych z AdomdConnection pozostaje aktywny i mogą być wielokrotnie używane przez innego AdomdConnection.Aby uzyskać więcej informacji na temat zarządzania sesjami, zobacz Praca z połączeniami i sesje w ADOMD.NET i SessionID.

Przykłady

Następujące podprocedury używa danej argumentów do utworzenia połączenia ciąg używający podprocedury aby spróbować połączyć się do określonego wystąpienie Usługi Analysis Services i powrót AdomdConnection:

Public Function Connect(Optional ByVal ServerID As String = "localhost", _
    Optional ByVal DatabaseID As String = "", _
    Optional ByVal UserID As String = "", _
    Optional ByVal Password As String = "") As AdomdConnection

    Dim strConnectionString As String
    Dim objConnection As AdomdConnection

    Try
        ' First, build the connection string.
        ' 
        ' The ConnectionString property consists of 
        
        ' key/value pairs seperated by semicolons.
        ' - The format, as a regular expression, should be:
        ' (<Key>=<Value>)*([[;]/*(<Key>=<Value>)])

        ' The connection string can take "Datasource", "Data Source", 
        ' or "Location" for this parameter.
        If ServerID <> "" Then
            strConnectionString &= "Data Source=" & ServerID & ";"
        End If

        ' The connection string can take "Catalog" or "Initial Catalog" 
        ' for this parameter.
        If DatabaseID <> "" Then
            strConnectionString &= "Initial Catalog=" & DatabaseID & ";"
        End If

        ' The connection string can take "UID", "User ID", 
        ' "Authenticated User", or "UserName" for this parameter.
        If UserID <> "" Then
            strConnectionString &= "User ID=" & UserID & ";"
        End If

        ' The connection string can take "PWD" or "Password" 
        ' for this parameter.
        If Password <> "" Then
            strConnectionString &= "Password=" & Password & ";"
        End If

        ' Get a reference to an AdomdConnection object.
        objConnection = New AdomdConnection()

        ' Assign the connection string and try to 
        ' open a connection.
        objConnection.ConnectionString = strConnectionString
        objConnection.Open()

        Catch ex As AdomdConnectionException
            ' The connection could not be opened or was disconnected.
            ' This error can occur at any time, if the provider is 
            ' disconnected from the server.
            Debug.WriteLine(ex)
        Catch ex As AdomdErrorResponseException
            ' A response is received from a provider that indicates an error.
            Debug.WriteLine(ex)
        Catch ex As AdomdUnknownResponseException
            ' A response has been returned from the provider that 
            ' was not understood.
            Debug.WriteLine(ex)
        Catch ex As AdomdCacheExpiredException
            ' A cached version of an ADOMD.NET object is no longer valid.
            ' This error is typically raised when reviewing metadata.
            Debug.WriteLine(ex)
        Catch ex As AdomdException
            ' Any other error raised by ADOMD.NET.
            Debug.WriteLine(ex)
        Catch ex As Exception
            ' Any other error that occurs.
            Debug.WriteLine(ex)
    Finally
        Debug.Write("The connection ")
        If objConnection.State = ConnectionState.Open Then
            Debug.WriteLine("is connected!")
        Else
            Debug.WriteLine("failed to connect!")
        End If
    End Try
    
    ' Return the AdomdConnection object.
    Return objConnection
End Function

Bezpieczeństwo wątków

Wszystkie publiczne statyczny (Shared w języku Visual Basic) elementy członkowskie tego typu są bezpieczne dla wątków. Nie ma gwarancji, że elementy członkowskie wystąpień będą bezpieczne dla wątków.

Zobacz także

Odwołanie

Przestrzeń nazw Microsoft.AnalysisServices.AdomdClient