다음을 통해 공유

WebPartManager.CloseProviderWarning 속성

  • 참조

정의

네임스페이스:
System.Web.UI.WebControls.WebParts
어셈블리:
System.Web.dll

연결에서 다른 컨트롤에 대해 공급자 역할을 하는 컨트롤을 사용자가 닫을 때 표시되는 경고를 가져오거나 설정합니다.

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

속성 값

String

경고 메시지가 들어 있는 문자열입니다. 기본값은 .NET Framework에서 제공하는 문화권별 메시지입니다.

예제

다음 코드 예제를 사용 하는 방법에 설명 합니다 사용자에 CloseProviderWarning 대 한 사용자 지정 경고를 표시 하는 속성입니다.

코드 예제에는 네 부분으로 구성됩니다.

  • 웹 파트 페이지의 디스플레이 모드를 변경할 수 있게 해 주는 사용자 정의 컨트롤입니다.

  • 두 개의 사용자 지정 컨트롤과 사용자 지정 WebPart 인터페이스가 포함된 소스 코드 파일입니다.

  • 연결할 수 있는 두 개의 사용자 지정 WebPart 컨트롤과 요소가 포함된 웹 페이지입니다 <asp:webpartmanager> .

  • 예제가 브라우저에서 작동하는 방식에 대한 설명입니다.

다음 코드는 예제의 웹 페이지 부분만 포함합니다. 위에서 언급한 사용자 지정 컨트롤에 대한 사용자 지정 사용자 컨트롤 및 소스 코드도 필요합니다. 클래스 개요의 예제 섹션에서 WebPartManager 이러한 두 항목을 가져옵니다.

다음 웹 페이지 코드는 요소의 선언적 태그 <asp:webpartmanager> 에서 속성에 CloseProviderWarning 사용자 지정 경고 메시지를 할당하는 방법을 보여 줍니다.

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

브라우저에서 웹 페이지를 로드한 후 표시 모드 드롭다운 목록 컨트롤을 클릭하고 연결을 선택하여 페이지를 연결 모드로 전환합니다. 연결 모드는 <asp:connectionszone> 요소를 사용하여 컨트롤 간에 연결을 만들 수 있도록 합니다. 연결 모드에서 우편 번호 컨트롤의 제목 표시줄에서 아래쪽 화살표를 클릭하여 동사 메뉴를 활성화한 다음 연결을 클릭합니다. 연결 UI(사용자 인터페이스)가 나타나면 소비자에 대한 연결 만들기 링크를 클릭합니다. 드롭다운 목록 컨트롤이 있는 셀이 나타납니다. 드롭다운 목록에서 날씨 제어 를 선택하고 연결을 클릭하여 두 컨트롤의 연결을 완료합니다. 닫기를 클릭한 다음 표시 모드 드롭다운 목록을 사용하여 페이지를 일반 찾아보기 모드로 반환합니다. 마지막으로 우편 번호 컨트롤의 동사 메뉴(이 경우 공급자 컨트롤)를 클릭하고 닫기를 선택합니다. 속성에 CloseProviderWarning 할당한 사용자 지정 메시지가 표시됩니다.

설명

사용자가 컨트롤을 닫으면 WebPart 일반적으로 메시지가 표시되지 않습니다. 컨트롤을 닫는 것이 무엇을 의미하는지에 대한 자세한 내용은 메서드를 CloseWebPart 참조하세요.

그러나 컨트롤이 다른 컨트롤에 연결되어 있고 다른 컨트롤에 대한 데이터 공급자 역할을 하는 경우 사용자가 컨트롤을 닫으려고 할 때 기본 경고 메시지가 표시됩니다. 이 메시지는 공급자 컨트롤이 닫히려고 한다는 것을 사용자에게 알려줍니다. 즉, 소비자가 더 이상 사용할 데이터가 없기 때문에 이 공급자에 연결된 컨트롤을 의미합니다. 이 CloseProviderWarning 속성을 사용하면 개발자가 사용자에게 표시되는 경고 메시지를 사용자 지정할 수 있습니다.

페이지 개발자가 이 속성에 빈 문자열 또는 null 문자열 값을 할당하는 경우 사용자가 공급자인 컨트롤을 닫 WebPart 을 때 경고 메시지 상자가 표시되지 않습니다.

적용 대상

추가 정보