WebPartManager.CloseProviderWarning Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls.WebParts

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mendapatkan atau mengatur peringatan yang ditampilkan saat pengguna menutup kontrol yang bertindak sebagai penyedia ke kontrol lain dalam koneksi.

public:
 virtual property System::String ^ CloseProviderWarning { System::String ^ get(); void set(System::String ^ value); };

public virtual string CloseProviderWarning { get; set; }

member this.CloseProviderWarning : string with get, set

Public Overridable Property CloseProviderWarning As String

Nilai Properti

String

String yang berisi pesan peringatan. Defaultnya adalah pesan khusus budaya yang disediakan oleh .NET Framework.

Contoh

Contoh kode berikut menunjukkan cara menggunakan CloseProviderWarning properti untuk menampilkan peringatan kustom kepada pengguna.

Contoh kode memiliki empat bagian:

Kontrol pengguna yang memungkinkan Anda mengubah mode tampilan pada halaman Bagian Web.
File kode sumber yang berisi dua kontrol kustom WebPart dan antarmuka kustom.
Halaman Web yang berisi dua kontrol kustom WebPart yang bisa disambungkan dan <asp:webpartmanager> elemen .
Penjelasan tentang cara kerja contoh di browser.

Kode berikut hanya berisi bagian halaman Web dari contoh. Anda juga akan memerlukan kontrol pengguna kustom dan kode sumber untuk kontrol kustom yang disebutkan di atas. Dapatkan kedua item ini dari bagian WebPartManager Contoh dari gambaran umum kelas.

Kode halaman Web berikut menunjukkan cara menetapkan pesan peringatan kustom ke CloseProviderWarning properti dalam markup deklaratif dalam <asp:webpartmanager> elemen .

<%@ Page Language="C#" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuCS" 
  Src="DisplayModeMenuCS.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.CS.Controls" 
  Assembly="ConnectionSampleCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <div>
      <uc1:DisplayModeMenuCS ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

<%@ Page Language="vb" %>
<%@ register TagPrefix="uc1" 
  TagName="DisplayModeMenuVB" 
  Src="DisplayModeMenuVB.ascx" %>
<%@ register tagprefix="aspSample" 
  Namespace="Samples.AspNet.VB.Controls" 
  Assembly="ConnectionSampleVB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">
      <!-- Reference the WebPartManager control. -->
      <asp:WebPartManager ID="WebPartManager1" runat="server"  
          CloseProviderWarning="You are closing a provider control." />
    <div>
      <uc1:DisplayModeMenuVB ID="displaymode1" runat="server" />
      <!-- Reference consumer and provider controls in a zone. -->
      <asp:WebPartZone ID="WebPartZone1" runat="server">
        <ZoneTemplate>
          <aspSample:ZipCodeWebPart ID="zip1" 
            runat="server" 
            Title="Zip Code Control"/>
          <aspSample:WeatherWebPart ID="weather1" 
            runat="server" 
            Title="Weather Control" />
        </ZoneTemplate>
      </asp:WebPartZone>
      <hr />
      <!-- Add a ConnectionsZone so users can connect controls. -->
      <asp:ConnectionsZone ID="ConnectionsZone1" runat="server" />
    </div>
    </form>
</body>
</html>

Setelah Anda memuat halaman Web di browser, klik kontrol daftar drop-down Mode Tampilan dan pilih Sambungkan untuk mengalihkan halaman ke mode sambungkan. Mode sambungkan menggunakan <asp:connectionszone> elemen untuk memungkinkan Anda membuat koneksi antar kontrol. Dalam mode sambungkan, klik panah ke bawah di bilah judul kontrol Kode Pos untuk mengaktifkan menu kata kerjanya, lalu klik Sambungkan. Setelah antarmuka pengguna koneksi (UI) muncul, klik tautan Buat koneksi ke Konsumen . Sel muncul yang memiliki kontrol daftar drop-down. Pilih Kontrol Cuaca di daftar drop-down, dan klik Sambungkan untuk menyelesaikan koneksi dua kontrol. Klik Tutup, lalu gunakan daftar drop-down Mode Tampilan untuk mengembalikan halaman ke mode penjelajahan normal. Terakhir, klik menu kata kerja untuk kontrol Kode Pos (yang merupakan kontrol penyedia dalam hal ini) dan pilih Tutup. Pesan kustom yang Anda tetapkan ke CloseProviderWarning properti ditampilkan.

Keterangan

Saat pengguna menutup WebPart kontrol, biasanya tidak ada pesan yang ditampilkan. Untuk informasi selengkapnya tentang apa artinya menutup kontrol, lihat CloseWebPart metode .

Namun, ketika kontrol tersambung ke kontrol lain dan bertindak sebagai penyedia data ke kontrol lain, pesan peringatan default ditampilkan ketika pengguna mencoba menutup kontrol. Pesan memberi tahu pengguna bahwa kontrol penyedia akan ditutup, yang berarti bahwa kontrol yang terhubung ke penyedia ini karena konsumen tidak akan lagi memiliki data untuk digunakan. Properti CloseProviderWarning memungkinkan pengembang untuk menyesuaikan pesan peringatan yang ditampilkan kepada pengguna.

Jika pengembang halaman menetapkan nilai string kosong atau null ke properti ini, tidak ada kotak pesan peringatan yang akan ditampilkan saat pengguna menutup WebPart kontrol yang merupakan penyedia.

Berlaku untuk

Lihat juga

ASP.NET Kontrol Bagian Web

Bagikan melalui