Класс NamedSet

Represents a named set for a given cube.

Иерархия наследования

System.Object
  Microsoft.AnalysisServices.AdomdClient.NamedSet

Пространство имен:  Microsoft.AnalysisServices.AdomdClient
Сборка:  Microsoft.AnalysisServices.AdomdClient (в Microsoft.AnalysisServices.AdomdClient.dll)

Синтаксис

'Декларация
Public NotInheritable Class NamedSet
'Применение
Dim instance As NamedSet

public sealed class NamedSet

public ref class NamedSet sealed

[<SealedAttribute>]
type NamedSet =  class end

public final class NamedSet

Тип NamedSet обеспечивает доступ к следующим элементам.

Свойства

	Имя	Описание
	Caption	Gets the caption of the named set.
	Description	Gets the description of the NamedSet.
	DisplayFolder	Gets the fully qualified name of a display folder.
	Expression	Gets the MDX set expression that defines the NamedSet.
	Name	Gets the name of the NamedSet.
	ParentCube	Gets a CubeDef that contains the NamedSet.
	Properties	Gets a PropertyCollection that contains the properties associated with the NamedSet.

В начало

Методы

	Имя	Описание
	Equals	Determines whether two instances of NamedSet are equal. (Переопределяет Object.Equals(Object).)
	GetHashCode	Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures such as hash tables. (Переопределяет Object.GetHashCode().)
	GetType	(Производный от Object.)
	ToString	Returns a String that represents the current object. (Переопределяет Object.ToString().)

В начало

Операторы

	Имя	Описание
	Equality	Determines whether two specified instances of NamedSet the same values.
	Inequality	Determines whether two specified instances of NamedSet have different values.

В начало

Замечания

A named set is a persisted set expression, which is associated with an alias and defined as part of the structure of a cube. In Multidimensional Expressions (MDX), a set expression can be a lengthy and complex declaration. A named set makes it easier to manage a set expression that is used regularly in MDX or XML for Analysis queries that involve the cube and provides a way of maintaining the set expression independently of the queries that use it.

A NamedSet encapsulates the alias and set expression of a named set, so that the metadata of the named set can be examined and incorporated into queries.

Примеры

The following subroutine, given a CubeDef, iterates through the NamedSets collection and displays information about each NamedSet in the collection:

Public Sub ListNamedSets(ByRef CubeToCheck As CubeDef)

    ' Check the parameter before performing actions on it.
    If CubeToCheck Is Nothing Then
        Throw New System.ArgumentNullException("CubeToCheck")
    Else
        ' Iterate through the NamedSets collection of the
        ' CubeDef object.

        Try
            Dim nsetToCheck As NamedSet

            Debug.WriteLine("Found " & CubeToCheck.NamedSets.Count & _
                " named set(s) in cube:")

            For Each nsetToCheck In CubeToCheck.NamedSets
                Debug.WriteLine("Named Set:  " & nsetToCheck.Name)
                Debug.WriteLine("    Description:  " & _
                    nsetToCheck.Description)
                Debug.WriteLine("    Expression:   " & _
                    nsetToCheck.Expression)
            Next
        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)
            Throw ex
        Catch ex As AdomdErrorResponseException
            ' A response is received from a provider which indicates an error.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As AdomdUnknownResponseException
            ' A response has been returned from the provider that 
            ' was not understood.
            Debug.WriteLine(ex)
            Throw 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)
            Throw ex
        Catch ex As AdomdException
            ' Any other error raised by ADOMD.NET.
            Debug.WriteLine(ex)
            Throw ex
        Catch ex As Exception
            ' Any other error.
            Debug.WriteLine(ex)
            Throw ex
        End Try
    End If
End Sub

Безопасность многопоточности

Любые открытые статический (Shared в Visual Basic) элементы этого типа потокобезопасны. Потокобезопасность с элементами экземпляров не гарантируется.

См. также

Справочник

Пространство имен Microsoft.AnalysisServices.AdomdClient