WebPartChrome.GetWebPartVerbs(WebPart) 메서드

정의

네임스페이스:

System.Web.UI.WebControls.WebParts

어셈블리:

System.Web.dll

WebPart 컨트롤을 사용하여 렌더링할 동사의 컬렉션을 가져옵니다.

protected:
 virtual System::Web::UI::WebControls::WebParts::WebPartVerbCollection ^ GetWebPartVerbs(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);

protected virtual System.Web.UI.WebControls.WebParts.WebPartVerbCollection GetWebPartVerbs (System.Web.UI.WebControls.WebParts.WebPart webPart);

abstract member GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection
override this.GetWebPartVerbs : System.Web.UI.WebControls.WebParts.WebPart -> System.Web.UI.WebControls.WebParts.WebPartVerbCollection

Protected Overridable Function GetWebPartVerbs (webPart As WebPart) As WebPartVerbCollection

매개 변수

webPart

WebPart

현재 렌더링되고 있는 컨트롤입니다.

반환

WebPartVerbCollection

webPart로 렌더링할 모든 동사가 포함된 WebPartVerbCollection입니다.

예외

ArgumentNullException

webPart이(가) null인 경우

예제

다음 코드 예제에서는 메서드의 사용을 보여 줍니다 GetWebPartVerbs . 예제를 실행 하는 데 필요한 전체 코드의 예제 섹션을 참조 하세요.를 WebPartChrome 클래스 개요 항목입니다.

코드 예제의 다음 섹션에서는 메서드를 재정의 GetWebPartVerbs 하는 방법을 보여 줍니다. 재정의된 메서드는 기본 메서드를 사용하여 컨트롤에서 webPart 모든 동사를 검색한 다음 동사 컬렉션을 반복하여 개체에 가까운 동사를 제외한 모든 동사를 ArrayList 추가합니다. 그러면 감소된 동사 집합이 호출자에게 반환되는 새 WebPartVerbCollection동사에 할당됩니다.

protected override WebPartVerbCollection GetWebPartVerbs(WebPart webPart)
{
  ArrayList verbSet = new ArrayList();
  foreach (WebPartVerb verb in base.GetWebPartVerbs(webPart))
  {
    if (verb.Text != "Close")
      verbSet.Add(verb);
  }
  WebPartVerbCollection reducedVerbSet = 
    new WebPartVerbCollection(verbSet);
  return reducedVerbSet;
}

Protected Overrides Function GetWebPartVerbs _
  (ByVal webPart As WebPart) As WebPartVerbCollection

  Dim verbSet As New ArrayList()
  Dim verb As WebPartVerb
  For Each verb In MyBase.GetWebPartVerbs(webPart)
    If verb.Text <> "Close" Then
      verbSet.Add(verb)
    End If
  Next verb

  Dim reducedVerbSet As WebPartVerbCollection = _
    New WebPartVerbCollection(verbSet)

  Return reducedVerbSet
End Function

브라우저에서 웹 페이지를 로드하고 각 WebPart 컨트롤의 동사 메뉴(제목 표시줄에 아래쪽 화살표로 표시됨)를 클릭하면 닫기 동사가 컨트롤에 대해 렌더링되지 않는 것을 볼 수 있습니다.

설명

이 GetWebPartVerbs 메서드는 개발자에게 메서드를 재정의하고 특정 동사가 렌더링되지 않도록 제외할 수 있는 기회를 제공합니다. 이는 동사가 렌더링되는 것을 제외할 FilterWebPartVerbs 수 있는 메서드와 비슷합니다.

그러나 GetWebPartVerbs 이 메서드는 동사를 렌더링할지 여부를 결정하기 위해 일부 조건을 확인하려는 경우를 위한 것이 아닙니다. 대신, 이 메서드는 특정 동사를 항상 제외하려는 미리 알고 있는 경우에 유용합니다. 예를 들어 사용자 지정 WebPartChrome 클래스를 개발하는 경우 사용자가 컨트롤을 닫을 수 없도록 항상 컨트롤에서 WebPart 가까운 동사를 제외하도록 결정할 수 있습니다. 속성을 false 모든 컨트롤에 설정하는 AllowClose 대신 메서드를 재정 GetWebPartVerbs 의하고 가까운 동사가 사용자 지정 WebPartChrome 개체로 렌더링된 모든 WebPart 컨트롤에서 렌더링되지 않도록 제외할 수 있습니다.

추가 정보

• ASP.NET 웹 파트 컨트롤