Column Klasse

Definition

Stellt eine Basisklasse eines Spaltenobjekts in einem tabellarischen Modell dar, das zur Angabe einer DataColumn, RowNumberColumn, CalculatedColumn oder CalculatedTableColumn verwendet wird.

public abstract class Column : Microsoft.AnalysisServices.Tabular.NamedMetadataObject, Microsoft.AnalysisServices.Tabular.IMetadataObjectWithLineage
type Column = class
    inherit NamedMetadataObject
    interface IMetadataObjectWithLineage
Public MustInherit Class Column
Inherits NamedMetadataObject
Implements IMetadataObjectWithLineage
Vererbung
Abgeleitet
Implementiert

Eigenschaften

Alignment

Gibt die Ausrichtung des Texts der Spalte in Berichtsvisualisierungen an. Die möglichen Werte sind Standard (1), Linksbündig (2), Rechtsbündig (3), Zentriert (4).

AlternateOf

Definiert die AlternateOf-Referenzquelle BaseTable oder BaseColumn und die Zusammenfassung.

Annotations

Ruft das Sammlungsobjekt aller Anmerkungen in der aktuellen Spalte ab.

AttributeHierarchy

Ein Verweis auf ein AttributeHierarchy-Objekt, das diesem ColumnOrigin-Objekt zugeordnet ist.

ChangedProperties

Ruft das Auflistungsobjekt aller geänderten Eigenschaften in der aktuellen Spalte ab.

DataCategory

Gibt den Typ der in der Spalte enthaltenen Daten an, damit Sie basierend auf dem Spaltentyp benutzerdefinierte Verhalten hinzufügen können. Es gibt 248 mögliche Werte. Die ersten zehn möglichen Werte sind Ungültig (–1), Alle (1), Normal (2), Bild (3), BildBMP (4), BildGIF (5), BildJPG (6), BildPNG (7), BildTIFF (8), BildURL (9), Id (10). Alle weiteren möglichen Werte finden Sie in der Dokumentation zum MS-SSAS-T SQL Server Analysis Services Tabular Protocol auf MSDN.

DataType

Gibt den Datentyp für eine DataColumn an. Unter https://msdn.microsoft.com/library/gg492146.aspx finden Sie eine Liste unterstützter Datentypen.

Description

Die Beschreibung der Spalte, die zur Entwurfszeit für Entwickler und für Administratoren in Verwaltungstools (z.B. SQL Server Management Studio) sichtbar ist.

DisplayFolder

Definiert den Anzeigeordner für die Spalte für die Verwendung durch Clients.

DisplayOrdinal

Gibt die visuelle Position der Spalte an, und zwar definiert als eine relative Reihenfolge statt einer strengen Reihenfolge (Beispiel: 10, 20, 40, 50). Dadurch können Clientanwendungen eine konsistente Spaltenposition beibehalten.

EncodingHint

Diese Eigenschaft ermöglicht die Angabe eines Codierungshinweises für die Spalte. Eine numerische Spalte kann entweder eine wertbasierte oder eine hashbasierte Codierung verwenden. In der Regel erkennt der Server automatisch die zu verwendende Codierung. Später kann jedoch eine Neucodierung stattfinden. Diese Eigenschaft ermöglicht die Übermittlung eines Hinweises an den Server, dass mit einem anderen Codierungstyp begonnen werden soll.

ErrorMessage

Eine Zeichenfolge, die den mit dem aktuellen Objekt verbundenen Fehlerzustand erläutert. Sie wird nur durch die Engine festgelegt, wenn der Zustand des Objekts einen der folgenden drei Werte aufweist: SemanticError, DependencyError oder EvaluationError. Dies gilt nur für Spalten vom Typ Calculated oder CalculatedTableColumn. Sie ist für andere Spaltenobjekte leer.

ExtendedProperties

Ruft das Collectionobjekt aller erweiterten Eigenschaften in der aktuellen Spalte ab.

FormatString

Eine Zeichenfolge, die das Format des Spalteninhalts angibt.

IsAvailableInMDX

Ein boolescher Wert, der angibt, ob die Spalte von der Verwendung in MDX-Abfragetools ausgeschlossen werden kann. FALSE., wenn die Spalte von der Verwendung in MDX-Abfragetools ausgeschlossen werden kann; andernfalls TRUE.

IsDataTypeInferred

Ein boolescher Wert, der angibt, ob der Datentyp abgeleitet ist.

IsDefaultImage

Ein boolescher Wert, der angibt, ob diese Spalte als DefaultImage-Eigenschaft in CSDL zurückgegeben wird.

IsDefaultLabel

Ein boolescher Wert, der angibt, ob diese Spalte im DisplayKey-Element in CSDL enthalten ist.

IsHidden

Ein boolescher Wert, der angibt, ob eine Spalte von Clientvisualisierungstools als ausgeblendetes Element behandelt wird. TRUE, wenn die Spalte als ausgeblendet behandelt wird; andernfalls FALSE.

IsKey

Ein boolescher Wert, der angibt, ob die Spalte ein Schlüssel der Tabelle ist. TRUE, wenn die Spalte ein Schlüssel der Tabelle ist; andernfalls FALSE.

IsNullable

Bei FALSE. kann die Spalte keine NULL-Werte enthalten. Selbst bei TRUE sind NULL-Werte unzulässig, wenn es sich um eine Schlüsselspalte handelt.

IsRemoved

Ein boolescher Wert, der angibt, ob dieses Objekt aus einer Objektstruktur entfernt wurde.

(Geerbt von MetadataObject)
IsUnique

Ein boolescher Wert, der angibt, ob die Spalte nur eindeutige Werte enthält. TRUE, wenn die Werte eindeutig sind; andernfalls FALSE.

KeepUniqueRows

Gibt das Gruppierungsverhalten für das Erstellen einer Hierarchie an. TRUE gruppiert nach Entitätsschlüssel. FALSE. gruppiert nach Wert.

LineageTag

Ein Tag, das die Linie des Objekts darstellt.

Model

Ruft das tabellarische Modell ab, das dieses Objekt enthält.

(Geerbt von MetadataObject)
ModifiedTime

Der Zeitpunkt, zu dem das Objekt zuletzt geändert wurde.

Name

Ruft den Namen einer Spalte in einem tabellarischen Modell ab oder legt ihn fest.

ObjectType

Ruft den Typ des Objekts ab.

Parent

Übergeordnetes Objekt, NULL für Model-Objekte.

RefreshedTime

Der Zeitpunkt, zu dem das Objekt zuletzt aktualisiert wurde.

RelatedColumnDetails

Ein Verweis auf ein RelatedColumnDetails-Objekt, das diesem Column-Objekt zugeordnet ist.

SortByColumn

Gibt an, dass die Spalte, die diese Eigenschaft definiert, nach den Werten der Spalte sortiert wird, auf die diese Eigenschaft verweist.

SourceLineageTag

Ein Tag, das die Zeile der Quelle für das Objekt darstellt.

SourceProviderType

Der ursprüngliche Datentyp der Spalte, wie in der Sprache der Datenquelle definiert. Dieser Datentyp wird verwendet, um direkte Abfragen der Datenquelle zu generieren, z.B. im DirectQuery-Modus.

State

Listet den Status der Spalte auf. Die folgenden Werte sind möglich. Ready (1) Die Spalte kann abgefragt werden und enthält aktuelle Daten. NoData (3) Die Spalte kann abgefragt werden, enthält aber keine Daten. Dieser Zustand gilt nur für Spalten vom Typ Data. CalculationNeeded (4) Die Spalte kann nicht abgefragt werden und muss aktualisiert (d.h. neu berechnet) werden, um funktionsfähig zu sein. Dieser Zustand gilt nur für Spalten vom Typ Calculated oder CalculatedTableColumn. SemanticError (5) Die Spalte befindet sich aufgrund eines ungültigen Ausdrucks im Fehlerzustand. Die Spalte kann nicht abgefragt werden. Dieser Zustand gilt nur für Spalten vom Typ Calculated oder CalculatedTableColumn. EvaluationError (6) Die Spalte befindet sich aufgrund eines Fehlers beim Auswerten des Ausdrucks im Fehlerzustand. Die Spalte kann nicht abgefragt werden. Dieser Zustand gilt nur für Spalten vom Typ Calculated oder CalculatedTableColumn. DependencyError (7) Die Spalte befindet sich im Fehlerzustand, da einige der zugehörigen Berechnungsabhängigkeiten einen fehlerhaften Zustand aufweisen. Die Spalte kann nicht abgefragt werden. Dieser Zustand gilt nur für Spalten vom Typ Calculated oder CalculatedTableColumn. Incomplete (8) Einige Teile der Spalte enthalten keine Daten. Die Spalte muss aktualisiert werden, damit die Daten importiert werden. Die Spalte kann abgefragt werden. Dieser Zustand gilt nur für Spalten vom Typ Data. SyntaxError (9) Die Spalte befindet sich im Fehlerzustand aufgrund eines Syntaxfehlers im Ausdruck. Die Spalte kann nicht abgefragt werden. Dieser Zustand gilt nur für Spalten vom Typ Calculated.

StructureModifiedTime

Der Zeitpunkt, zu dem die Objektstruktur zuletzt geändert wurde.

SummarizeBy

Ein Wert, der die Standardfunktion angibt (sofern vorhanden), mit der das Feld aggregiert wird. Die möglichen Werte sind Standard (1), Keine (2), Sum (3), Min (4), Max (5), Count (6), Average (7), DistinctCount (8). Wenn die Werte nicht angegeben werden, wird für numerische Felder „Standard“ angenommen bzw. für alle anderen Felder „Keine“.

Table

Ein Verweis auf ein Tabellenobjekt, das diese Spalte besitzt.

TableDetailPosition

Legt fest, ob diese Spalte in die DefaultDetails-Collection der Tabelle aufgenommen werden kann. Diese Collection ist eine geordnete Menge von Spaltentypen. Ein positiver Wert gibt an, dass die Spalte in der Collection enthalten ist. Die Collection ist in aufsteigender Reihenfolge dieses Elements sortiert. Die DefaultDetails-Collection wird als Teil der CSDL-Metadaten durch den Vorgang DISCOVER_CSDL_METADATA zurückgegeben.

Type

Gibt die Datenbindung an. Zu den Werten gehören Data (1), wobei der Inhalt dieser Spalte aus einer DataSource stammt, Calculated (2), wobei der Inhalt nach dem Befüllen der Datenspalten anhand eines Ausdrucks berechnet wird, RowNumber (3), wobei die Spalte einer internen Spalte entspricht und die Zeilennummer darstellt, oder CalculatedTableColumn (4), wobei Tabellen, die auf einem berechneten Ausdruck basieren, automatisch die Spalten in der Tabelle ableiten und generieren.

Variations

Ruft das Collectionobjekt aller Variationen in der aktuellen Spalte ab.

Methoden

Clone()

Erstellt eine neue vollständige Kopie eines Column-Objekts.

CopyFrom(Column)
Veraltet.

Veraltet. Verwenden Sie stattdessen die CopyTo-Methode.

CopyTo(Column)

Kopiert ein Column-Objekt in das angegebene Objekt.

Rename(String)
Veraltet.

Veraltet. Verwenden Sie stattdessen die RequestRename-Methode.

RequestRename(String)

Umbenennen dieses Objekts anfordern.

Validate()

Diese API unterstützt die Produktinfrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code gedacht. Nur Microsoft-interne Verwendung.

(Geerbt von MetadataObject)

Gilt für: