Bagikan melalui

Membuat Tampilan Tabel

Tampilan tabel menampilkan data dalam satu atau beberapa kolom. Setiap baris dalam tabel mewakili objek .NET, dan setiap kolom tabel mewakili properti objek atau nilai skrip. Anda dapat menentukan tampilan tabel yang menampilkan semua properti objek atau subset properti objek.

Tampilan Tabel

Contoh berikut menunjukkan bagaimana Windows PowerShell menampilkan objek System.ServiceProcess.ServiceController yang dikembalikan oleh cmdlet Get-Service. Untuk objek ini, Windows PowerShell telah menentukan tampilan tabel yang menampilkan properti Status, properti Name (properti ini adalah properti alias untuk properti ServiceName), dan properti DisplayName. Setiap baris dalam tabel mewakili objek yang dikembalikan oleh cmdlet.

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

Menentukan Tampilan Tabel

XML berikut menunjukkan skema tampilan tabel untuk menampilkan objek System.ServiceProcess.ServiceController. Anda harus menentukan setiap properti yang ingin Anda tampilkan dalam tampilan tabel.

<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>

Elemen XML berikut digunakan untuk menentukan tampilan daftar:

  • Elemen Tampilan adalah elemen induk tampilan tabel. (Ini adalah elemen induk yang sama untuk tampilan kontrol daftar, lebar, dan kustom.)

  • Elemen Nama menentukan nama tampilan. Elemen ini diperlukan untuk semua tampilan.

  • Elemen ViewSelectedBy menentukan objek yang menggunakan tampilan. Elemen ini diperlukan.

  • Elemen GroupBy (tidak ditampilkan dalam contoh ini) menentukan kapan grup objek baru ditampilkan. Grup baru dimulai setiap kali nilai properti atau skrip tertentu berubah. Elemen ini bersifat opsional.

  • Elemen Kontrol (tidak diperlihatkan dalam contoh ini) menentukan kontrol kustom yang ditentukan oleh tampilan tabel. Kontrol memberi Anda cara untuk menentukan lebih lanjut bagaimana data ditampilkan. Elemen ini bersifat opsional. Tampilan dapat menentukan kontrol kustomnya sendiri, atau dapat menggunakan kontrol umum yang dapat digunakan oleh tampilan apa pun dalam file pemformatan. Untuk informasi selengkapnya tentang kontrol kustom, lihat Membuat Kontrol Kustom.

  • Elemen HideTableHeaders (tidak ditampilkan dalam contoh ini) menentukan bahwa tabel tidak akan menampilkan label apa pun di bagian atas tabel. Elemen ini bersifat opsional.

  • Elemen TableControl yang menentukan informasi header dan baris tabel. Mirip dengan semua tampilan lainnya, tampilan tabel dapat menampilkan nilai properti objek atau nilai yang dihasilkan oleh skrip.

Menentukan Header Kolom

  1. Elemen TableHeaders dan elemen turunannya menentukan apa yang ditampilkan di bagian atas tabel.

  2. Elemen TableColumnHeader menentukan apa yang ditampilkan di bagian atas kolom tabel. Tentukan elemen-elemen ini dalam urutan yang Anda inginkan untuk menampilkan header.

    Tidak ada batasan jumlah elemen ini yang dapat Anda gunakan, tetapi jumlah elemen TableColumnHeader dalam tampilan tabel Anda harus sama dengan jumlah elemen TableRowEntry yang Anda gunakan.

  3. Elemen Label menentukan teks yang ditampilkan. Elemen ini bersifat opsional.

  4. Elemen Lebar menentukan lebar (dalam karakter) kolom. Elemen ini bersifat opsional.

  5. Elemen Perataan menentukan bagaimana label ditampilkan. Label dapat diratakan ke kiri, ke kanan, atau tengah. Elemen ini bersifat opsional.

Menentukan Baris Tabel

Tampilan tabel dapat menyediakan satu atau beberapa definisi yang menentukan data apa yang ditampilkan dalam baris tabel dengan menggunakan elemen turunan dari elemen TableRowEntries. Perhatikan bahwa Anda dapat menentukan beberapa definisi untuk baris tabel, tetapi header untuk baris tetap sama, terlepas dari definisi baris apa yang digunakan. Biasanya, tabel hanya akan memiliki satu definisi.

Dalam contoh berikut, tampilan menyediakan definisi tunggal yang menampilkan nilai beberapa properti objek System.Diagnostics.Process. Tampilan tabel dapat menampilkan nilai properti atau nilai skrip (tidak diperlihatkan dalam contoh) dalam barisnya.

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

Elemen XML berikut dapat digunakan untuk menyediakan definisi untuk baris:

  • Elemen TableRowEntries dan elemen turunannya menentukan apa yang ditampilkan dalam baris tabel.

  • Elemen TableRowEntry menyediakan definisi baris. Diperlukan setidaknya satu TableRowEntry; namun, tidak ada batas maksimum untuk jumlah elemen yang dapat Anda tambahkan. Dalam kebanyakan kasus, tampilan hanya akan memiliki satu definisi.

  • Elemen EntrySelectedBy menentukan objek yang ditampilkan oleh definisi tertentu. Elemen ini bersifat opsional dan hanya diperlukan saat Anda menentukan beberapa elemen TableRowEntry yang menampilkan objek yang berbeda.

  • Elemen Bungkus menentukan bahwa teks yang melebihi lebar kolom ditampilkan pada baris berikutnya. Secara default, teks yang melebihi lebar kolom dipotong.

  • Elemen TableColumnItems menentukan properti atau skrip yang nilainya ditampilkan dalam baris.

  • Elemen TableColumnItem menentukan properti atau skrip yang nilainya ditampilkan di kolom baris. Elemen TableColumnItem diperlukan untuk setiap kolom baris. Entri pertama ditampilkan di kolom pertama, entri kedua di kolom kedua, dan sebagainya.

  • Elemen PropertyName menentukan properti yang nilainya ditampilkan dalam baris. Anda harus menentukan properti atau skrip, tetapi Anda tidak dapat menentukan keduanya.

  • Elemen ScriptBlock menentukan skrip yang nilainya ditampilkan dalam baris. Anda harus menentukan skrip atau properti, tetapi Anda tidak dapat menentukan keduanya.

  • Elemen FormatString menentukan pola format yang menentukan bagaimana nilai properti atau skrip ditampilkan. Elemen ini bersifat opsional.

  • Elemen Perataan menentukan bagaimana nilai properti atau skrip ditampilkan. Nilai dapat diratakan ke kiri, ke kanan, atau di tengah. Elemen ini bersifat opsional.

Menentukan Objek yang Menggunakan Tampilan Tabel

Ada dua cara untuk menentukan objek .NET mana yang menggunakan tampilan tabel. Anda dapat menggunakan elemen ViewSelectedBy untuk menentukan objek yang dapat ditampilkan oleh semua definisi tampilan, atau Anda dapat menggunakan elemen EntrySelectedBy untuk menentukan objek mana yang ditampilkan oleh definisi tampilan tertentu. Dalam kebanyakan kasus, tampilan hanya memiliki satu definisi, sehingga objek biasanya ditentukan oleh elemen ViewSelectedBy.

Contoh berikut menunjukkan cara menentukan objek yang ditampilkan oleh tampilan tabel menggunakan elemen ViewSelectedBy dan TypeName. Tidak ada batasan jumlah elemen TypeName yang dapat Anda tentukan, dan urutannya tidak signifikan.

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

Elemen XML berikut dapat digunakan untuk menentukan objek yang digunakan oleh tampilan tabel:

  • Elemen ViewSelectedBy menentukan objek mana yang ditampilkan oleh tampilan daftar.

  • Elemen TypeName menentukan objek .NET yang ditampilkan oleh tampilan. Nama jenis .NET yang sepenuhnya memenuhi syarat diperlukan. Anda harus menentukan setidaknya satu jenis atau seleksi yang ditetapkan untuk tampilan, tetapi tidak ada jumlah maksimum elemen yang dapat ditentukan.

Contoh berikut menggunakan elemen ViewSelectedBy dan SelectionSetName. Gunakan set pilihan tempat Anda memiliki sekumpulan objek terkait yang ditampilkan menggunakan beberapa tampilan, seperti saat Anda menentukan tampilan daftar dan tampilan tabel untuk objek yang sama. Untuk informasi selengkapnya tentang cara membuat kumpulan pilihan, lihat Menentukan Set Pilihan.

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

Elemen XML berikut dapat digunakan untuk menentukan objek yang digunakan oleh tampilan daftar:

  • Elemen ViewSelectedBy menentukan objek mana yang ditampilkan oleh tampilan daftar.

  • Elemen SelectionSetName menentukan sekumpulan objek yang dapat ditampilkan oleh tampilan. Anda harus menentukan setidaknya satu set pilihan atau jenis untuk tampilan, tetapi tidak ada jumlah maksimum elemen yang dapat ditentukan.

Contoh berikut menunjukkan cara menentukan objek yang ditampilkan oleh definisi tertentu dari tampilan tabel menggunakan elemen EntrySelectedBy. Dengan menggunakan elemen ini, Anda dapat menentukan nama jenis .NET objek, sekumpulan objek pilihan, atau kondisi pilihan yang menentukan kapan definisi digunakan. Untuk informasi selengkapnya tentang cara membuat kondisi pilihan, lihat Menentukan Kondisi untuk Menampilkan Data.

Nota

Saat membuat beberapa definisi tampilan tabel, Anda tidak dapat menentukan header kolom yang berbeda. Anda hanya dapat menentukan apa yang ditampilkan dalam baris tabel, seperti objek apa yang ditampilkan.

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

Elemen XML berikut dapat digunakan untuk menentukan objek yang digunakan oleh definisi tertentu dari tampilan daftar:

  • Elemen EntrySelectedBy menentukan objek mana yang ditampilkan oleh definisi.

  • Elemen TypeName menentukan objek .NET yang ditampilkan oleh definisi. Saat menggunakan elemen ini, nama jenis .NET yang sepenuhnya memenuhi syarat diperlukan. Anda harus menentukan setidaknya satu jenis, set pilihan, atau kondisi pilihan untuk definisi, tetapi tidak ada jumlah maksimum elemen yang dapat ditentukan.

  • Elemen SelectionSetName (tidak ditampilkan) menentukan sekumpulan objek yang dapat ditampilkan oleh definisi ini. Anda harus menentukan setidaknya satu jenis, set pilihan, atau kondisi pilihan untuk definisi, tetapi tidak ada jumlah maksimum elemen yang dapat ditentukan.

  • Elemen SelectionCondition (tidak ditampilkan) menentukan kondisi yang harus ada agar definisi ini digunakan. Anda harus menentukan setidaknya satu jenis, set pilihan, atau kondisi pilihan untuk definisi, tetapi tidak ada jumlah maksimum elemen yang dapat ditentukan. Untuk informasi selengkapnya tentang menentukan kondisi pilihan, lihat Menentukan Kondisi untuk Menampilkan Data.

Menggunakan Format String

String pemformatan dapat ditambahkan ke tampilan untuk menentukan lebih lanjut bagaimana data ditampilkan. Contoh berikut menunjukkan cara menentukan string pemformatan untuk nilai properti StartTime.

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

Elemen XML berikut dapat digunakan untuk menentukan pola format:

  • Elemen TableColumnItem menentukan properti atau skrip yang nilainya ditampilkan di kolom baris. Elemen TableColumnItem diperlukan untuk setiap kolom baris. Entri pertama ditampilkan di kolom pertama, entri kedua di kolom kedua, dan sebagainya.

  • Elemen PropertyName menentukan properti yang nilainya ditampilkan dalam baris. Anda harus menentukan properti atau skrip, tetapi Anda tidak dapat menentukan keduanya.

  • Elemen FormatString menentukan pola format yang menentukan bagaimana nilai properti atau skrip ditampilkan.

Dalam contoh berikut, metode ToString dipanggil untuk memformat nilai skrip. Skrip dapat memanggil metode objek apa pun. Oleh karena itu, jika objek memiliki metode, seperti ToString, yang memiliki parameter pemformatan, skrip dapat memanggil metode tersebut untuk memformat nilai output skrip.

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

Elemen XML berikut dapat digunakan untuk memanggil metode ToString:

  • Elemen TableColumnItem menentukan properti atau skrip yang nilainya ditampilkan di kolom baris. Elemen TableColumnItem diperlukan untuk setiap kolom baris. Entri pertama ditampilkan di kolom pertama, entri kedua di kolom kedua, dan sebagainya.

  • Elemen ScriptBlock menentukan skrip yang nilainya ditampilkan dalam baris. Anda harus menentukan skrip atau properti, tetapi Anda tidak dapat menentukan keduanya.

Lihat Juga

Menulis File Pemformatan PowerShell

  • Last updated on