Tablo Görünümü Oluşturma

Makale
2025-03-25

Tablo görünümü verileri bir veya daha fazla sütunda görüntüler. Tablodaki her satır bir .NET nesnesini temsil eder ve tablonun her sütunu nesnenin veya betik değerinin bir özelliğini temsil eder. Bir nesnenin tüm özelliklerini veya bir nesnenin özelliklerinin alt kümesini görüntüleyen bir tablo görünümü tanımlayabilirsiniz.

Tablo Görünümü Görünümü

Aşağıdaki örnekte, Windows PowerShell'in Get-Service cmdlet'i tarafından döndürülen System.ServiceProcess.ServiceController nesnesini nasıl görüntülediği gösterilmektedir. Bu nesne için, Windows PowerShell Status özelliğini, Name özelliğini (bu özellik ServiceName özelliği için bir diğer ad özelliğidir) ve DisplayName özelliğini görüntüleyen bir tablo görünümü tanımlamıştır. Tablodaki her satır, cmdlet tarafından döndürülen bir nesneyi temsil eder.

Status   Name               DisplayName
------   ----               -----------
Stopped  AJRouter           AllJoyn Router Service
Stopped  ALG                Application Layer Gateway Service
Stopped  AppIDSvc           Application Identity
Running  Appinfo            Application Information

Tablo Görünümünü Tanımlama

Aşağıdaki XML, System.ServiceProcess.ServiceController nesnesini görüntülemek için tablo görünümü şemasını gösterir. Tablo görünümünde görüntülenmesini istediğiniz her özelliği belirtmeniz gerekir.

<View>
  <Name>service</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <TableControl>
    <TableHeaders>
      <TableColumnHeader>
        <Width>8</Width>
      </TableColumnHeader>
      <TableColumnHeader>
        <Width>18</Width>
      </TableColumnHeader>
      <TableColumnHeader>
        <Width>38</Width>
      </TableColumnHeader>
    </TableHeaders>
    <TableRowEntries>
      <TableRowEntry>
        <TableColumnItems>
          <TableColumnItem>
           <PropertyName>Status</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>Name</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>DisplayName</PropertyName>
          </TableColumnItem>
        </TableColumnItems>
      </TableRowEntry>
    </TableRowEntries>
  </TableControl>
</View>

Liste görünümünü tanımlamak için aşağıdaki XML öğeleri kullanılır:

Görünüm öğesi, tablo görünümünün üst öğesidir. (Bu, liste, geniş ve özel denetim görünümleri için aynı üst öğedir.)
Adı öğesi görünümün adını belirtir. Bu öğe tüm görünümler için gereklidir.
ViewSelectedBy öğesi, görünümü kullanan nesneleri tanımlar. Bu öğe gereklidir.
GroupBy öğesi (bu örnekte gösterilmez) yeni bir nesne grubunun ne zaman görüntüleneceğini tanımlar. Belirli bir özelliğin veya betiğin değeri her değiştiğinde yeni bir grup başlatılır. Bu öğe isteğe bağlıdır.
Denetimleri öğesi (bu örnekte gösterilmez) tablo görünümü tarafından tanımlanan özel denetimleri tanımlar. Denetimler, verilerin nasıl görüntüleneceğini daha fazla belirtmeniz için size bir yol sağlar. Bu öğe isteğe bağlıdır. Görünüm kendi özel denetimlerini tanımlayabilir veya biçimlendirme dosyasındaki herhangi bir görünüm tarafından kullanılabilecek ortak denetimleri kullanabilir. Özel denetimler hakkında daha fazla bilgi için bkz. Özel Denetim oluşturma.
HideTableHeaders öğesi (bu örnekte gösterilmez), tablonun tablonun en üstünde hiçbir etiket göstermeyeceklerini belirtir. Bu öğe isteğe bağlıdır.
tablonun üst bilgi ve satır bilgilerini tanımlayan TableControl öğesi. Diğer tüm görünümlere benzer şekilde, tablo görünümü de nesne özelliklerinin veya betikler tarafından oluşturulan değerlerin değerlerini görüntüleyebilir.

Sütun Üst Bilgilerini Tanımlama

TableHeaders öğesi ve alt öğeleri tablonun en üstünde görüntülenen öğeleri tanımlar.
TableColumnHeader öğesi, tablonun sütununun en üstünde görüntülenen öğeleri tanımlar. Bu öğeleri üst bilgilerin görüntülenmesini istediğiniz sırada belirtin.

Kullanabileceğiniz bu öğenin sayısıyla ilgili bir sınır yoktur, ancak tablo görünümünüzdeki TableColumnHeader öğelerinin sayısı, kullandığınız TableRowEntry öğelerinin sayısına eşit olmalıdır.
Label öğesi, görüntülenen metni belirtir. Bu öğe isteğe bağlıdır.
Width öğesi sütunun genişliğini (karakter cinsinden) belirtir. Bu öğe isteğe bağlıdır.
Hizalama öğesi etiketin nasıl görüntüleneceğini belirtir. Etiket sola, sağa hizalanabilir veya ortalanabilir. Bu öğe isteğe bağlıdır.

Tablo Satırlarını Tanımlama

Tablo görünümleri, TableRowEntries öğesinin alt öğelerini kullanarak tablonun satırlarında hangi verilerin görüntüleneceğini belirten bir veya daha fazla tanım sağlayabilir. Tablonun satırları için birden çok tanım belirtebileceğinize, ancak hangi satır tanımının kullanıldığına bakılmaksızın satırların üst bilgilerinin aynı kaldığına dikkat edin. Genellikle, bir tablonun tek bir tanımı olur.

Aşağıdaki örnekte görünüm, System.Diagnostics.Process nesnesinin çeşitli özelliklerinin değerlerini görüntüleyen tek bir tanım sağlar. Tablo görünümü, bir özelliğin değerini veya betiğin değerini (örnekte gösterilmez) satırlarında görüntüleyebilir.

<TableRowEntries>
      <TableRowEntry>
        <TableColumnItems>
          <TableColumnItem>
           <PropertyName>Status</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>Name</PropertyName>
          </TableColumnItem>
          <TableColumnItem>
            <PropertyName>DisplayName</PropertyName>
          </TableColumnItem>
        </TableColumnItems>
      </TableRowEntry>
    </TableRowEntries>

Aşağıdaki XML öğeleri bir satır için tanım sağlamak için kullanılabilir:

TableRowEntries öğesi ve alt öğeleri tablonun satırlarında görüntülenen öğeleri tanımlar.
TableRowEntry öğesi satırın tanımını sağlar. En az bir TableRowEntry gereklidir; ancak, ekleyebileceğiniz öğe sayısı için üst sınır yoktur. Çoğu durumda, bir görünümün tek bir tanımı olur.
EntrySelectedBy öğesi, belirli bir tanım tarafından görüntülenen nesneleri belirtir. Bu öğe isteğe bağlıdır ve yalnızca farklı nesneler görüntüleyen birden çok TableRowEntry öğesi tanımladığınızda gereklidir.
Wrap öğesi, sütun genişliğini aşan metnin sonraki satırda görüntüleneceğini belirtir. Varsayılan olarak, sütun genişliğini aşan metin kesilir.
TableColumnItems öğesi, değerleri satırda görüntülenen özellikleri veya betikleri tanımlar.
TableColumnItem öğesi, değeri satırın sütununda görüntülenen özelliği veya betiği tanımlar. Satırın her sütunu için bir TableColumnItem öğesi gerekir. İlk girdi ilk sütunda, ikinci girdi ikinci sütunda vb. görüntülenir.
PropertyName öğesi, değeri satırda görüntülenen özelliği belirtir. Bir özellik veya betik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
ScriptBlock öğesi, değeri satırda görüntülenen betiği belirtir. Bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
FormatString öğesi, özelliğin veya betik değerinin nasıl görüntüleneceğini tanımlayan bir biçim deseni belirtir. Bu öğe isteğe bağlıdır.
Hizalama öğesi, özelliğin veya betiğin değerinin nasıl görüntüleneceğini belirtir. Değer sola, sağa hizalanabilir veya ortalanabilir. Bu öğe isteğe bağlıdır.

Tablo Görünümünü Kullanan Nesneleri Tanımlama

Tablo görünümünü hangi .NET nesnelerinin kullandığını tanımlamanın iki yolu vardır. görünümün tüm tanımları tarafından görüntülenebilen nesneleri tanımlamak için ViewSelectedBy öğesini kullanabilir veya görünümün belirli bir tanımıyla hangi nesnelerin görüntüleneceğini tanımlamak için EntrySelectedBy öğesini kullanabilirsiniz. Çoğu durumda, bir görünümün tek bir tanımı vardır, bu nedenle nesneler genellikle ViewSelectedBy öğesi tarafından tanımlanır.

Aşağıdaki örnekte, ViewSelectedBy ve TypeName öğeleri kullanılarak tablo görünümü tarafından görüntülenen nesnelerin nasıl tanımlanacağı gösterilmektedir. Belirtebileceğiniz TypeName öğelerinin sayısıyla ilgili bir sınır yoktur ve bunların sırası önemli değildir.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <TypeName>System.ServiceProcess.ServiceController</TypeName>
  </ViewSelectedBy>
  <TableControl>...</TableControl>
</View>

Tablo görünümü tarafından kullanılan nesneleri belirtmek için aşağıdaki XML öğeleri kullanılabilir:

ViewSelectedBy öğesi, liste görünümü tarafından hangi nesnelerin görüntüleneceğini tanımlar.
TypeName öğesi, görünüm tarafından görüntülenen .NET nesnesini belirtir. Tam .NET türü adı gereklidir. Görünüm için en az bir tür veya seçim kümesi belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.

Aşağıdaki örnek, ViewSelectedBy ve SelectionSetName öğelerini kullanır. Bir liste görünümü ve aynı nesneler için tablo görünümü tanımladığınızda olduğu gibi, birden çok görünüm kullanılarak görüntülenen ilgili bir nesne kümeniz olan seçim kümelerini kullanın. Seçim kümesi oluşturma hakkında daha fazla bilgi için bkz. Seçim Kümelerini Tanımlama.

<View>
  <Name>System.ServiceProcess.ServiceController</Name>
  <ViewSelectedBy>
    <SelectionSetName>.NET Type Set</SelectionSetName>
  </ViewSelectedBy>
  <TableControl>...</TableControl>
</View>

Liste görünümü tarafından kullanılan nesneleri belirtmek için aşağıdaki XML öğeleri kullanılabilir:

ViewSelectedBy öğesi, liste görünümü tarafından hangi nesnelerin görüntüleneceğini tanımlar.
SelectionSetName öğesi, görünüm tarafından görüntülenebilen bir nesne kümesini belirtir. Görünüm için en az bir seçim kümesi veya tür belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.

Aşağıdaki örnekte, EntrySelectedBy öğesi kullanılarak tablo görünümünün belirli bir tanımıyla görüntülenen nesnelerin nasıl tanımlanacağı gösterilmektedir. Bu öğeyi kullanarak nesnenin .NET tür adını, bir nesne seçim kümesini veya tanımın ne zaman kullanılacağını belirten bir seçim koşulu belirtebilirsiniz. Seçim koşulları oluşturma hakkında daha fazla bilgi için bkz. veri Görüntülemek için Koşulları Tanımlama.

Uyarı

Tablo görünümünün birden çok tanımını oluştururken farklı sütun üst bilgileri belirtemezsiniz. Yalnızca tablonun satırlarında görüntülenen nesneleri (örneğin, hangi nesnelerin görüntüleneceğini) belirtebilirsiniz.

<TableRowEntry>
  <EntrySelectedBy>
    <TypeName>.NET Type</TypeName>
  </EntrySelectedBy>
</TableRowEntry>

Liste görünümünün belirli bir tanımı tarafından kullanılan nesneleri belirtmek için aşağıdaki XML öğeleri kullanılabilir:

EntrySelectedBy öğesi tanım tarafından hangi nesnelerin görüntüleneceğini tanımlar.
TypeName öğesi, tanım tarafından görüntülenen .NET nesnesini belirtir. Bu öğe kullanılırken, tam .NET türü adı gereklidir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.
SelectionSetName öğesi (gösterilmez), bu tanım tarafından görüntülenebilen bir nesne kümesi belirtir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur.
SelectionCondition öğesi (gösterilmez), bu tanımın kullanılabilmesi için var olması gereken bir koşulu belirtir. Tanım için en az bir tür, seçim kümesi veya seçim koşulu belirtmeniz gerekir, ancak belirtilebilen en fazla öğe sayısı yoktur. Seçim koşullarını tanımlama hakkında daha fazla bilgi için bkz. VeriGörüntülemek için Koşulları Tanımlama .

Biçim Dizelerini Kullanma

Verilerin nasıl görüntüleneceğini daha ayrıntılı tanımlamak için görünüme biçimlendirme dizeleri eklenebilir. Aşağıdaki örnekte, StartTime özelliğinin değeri için biçimlendirme dizesinin nasıl tanımlanacağı gösterilmektedir.

<TableColumnItem>
  <PropertyName>StartTime</PropertyName>
  <FormatString>{0:MMM} {0:DD} {0:HH}:{0:MM}</FormatString>
</TableColumnItem>

Biçim deseni belirtmek için aşağıdaki XML öğeleri kullanılabilir:

TableColumnItem öğesi, değeri satırın sütununda görüntülenen özelliği veya betiği tanımlar. Satırın her sütunu için bir TableColumnItem öğesi gerekir. İlk girdi ilk sütunda, ikinci girdi ikinci sütunda vb. görüntülenir.
PropertyName öğesi, değeri satırda görüntülenen özelliği belirtir. Bir özellik veya betik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.
FormatString öğesi, özelliğin veya betik değerinin nasıl görüntüleneceğini tanımlayan bir biçim deseni belirtir.

Aşağıdaki örnekte, betiğin değerini biçimlendirmek için ToString yöntemi çağrılır. Betikler bir nesnenin herhangi bir yöntemini çağırabilir. Bu nedenle, bir nesnenin biçimlendirme parametreleri olan ToStringgibi bir yöntemi varsa, betiğin çıkış değerini biçimlendirmek için bu yöntemi çağırabilir.

<ListItem>
  <ScriptBlock>
    [string]::Format("{0,-10} {1,-8}", $_.LastWriteTime.ToString("d"), $_.LastWriteTime.ToString("t"))
  </ScriptBlock>
</ListItem>

aşağıdaki XML öğesi, ToString yöntemini çağırmak için kullanılabilir:

TableColumnItem öğesi, değeri satırın sütununda görüntülenen özelliği veya betiği tanımlar. Satırın her sütunu için bir TableColumnItem öğesi gerekir. İlk girdi ilk sütunda, ikinci girdi ikinci sütunda vb. görüntülenir.
ScriptBlock öğesi, değeri satırda görüntülenen betiği belirtir. Bir betik veya özellik belirtmeniz gerekir, ancak ikisini birden belirtemezsiniz.

Ayrıca Bkz.

PowerShell Biçimlendirme Dosyasını Yazma

Aracılığıyla paylaş