WebPartTransformerAttribute 클래스

정의

public ref class WebPartTransformerAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Class)]
public sealed class WebPartTransformerAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Class)>]
type WebPartTransformerAttribute = class
    inherit Attribute

Public NotInheritable Class WebPartTransformerAttribute
Inherits Attribute

상속

Object

Attribute

WebPartTransformerAttribute

특성

AttributeUsageAttribute

예제

다음 코드 예제에서는 사용자 지정된 WebPartTransformerAttribute 클래스에서 WebPartTransformer 특성을 사용하는 방법을 보여 줍니다. 이 특성은 클래스가 RowToStringTransformer 형식의 공급자 연결 지점을 형식 IWebPartRow 의 소비자 연결 지점 IString으로 변환할 수 있음을 나타냅니다.

이 코드 예제는 클래스 개요에 있는 더 큰 예제의 WebPartTransformer 일부입니다.

// A transformer that transforms a row to a string.
[AspNetHostingPermission(SecurityAction.Demand,
  Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
  Level = AspNetHostingPermissionLevel.Minimal)]
[WebPartTransformer(typeof(IWebPartRow), typeof(IString))]
public class RowToStringTransformer : WebPartTransformer, IString
{

    private IWebPartRow _provider;
    private StringCallback _callback;

    private void GetRowData(object rowData)
    {
        PropertyDescriptorCollection props = _provider.Schema;
        if (props != null && props.Count > 0 && rowData != null)
        {
            string returnValue = String.Empty;
            foreach (PropertyDescriptor prop in props)
            {
                if (prop != props[0])
                {
                    returnValue += ", ";
                }
                returnValue += prop.DisplayName + ": " + prop.GetValue(rowData);
            }
            _callback(returnValue);
        }
        else
        {
            _callback(null);
        }
    }
    
    public override object Transform(object providerData)
    {
        _provider = (IWebPartRow)providerData;
        return this;
    }

    void IString.GetStringValue(StringCallback callback)
    {
        if (callback == null)
        {
            throw new ArgumentNullException("callback");
        }

        if (_provider != null)
        {
            _callback = callback;
            _provider.GetRowData(new RowCallback(GetRowData));
        }
        else
        {
            callback(null);
        }
    }
}

' A transformer that transforms a row to a string.
<AspNetHostingPermission(SecurityAction.Demand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
   Level:=AspNetHostingPermissionLevel.Minimal)> _
<WebPartTransformer(GetType(IWebPartRow), GetType(IString))> _
Public Class RowToStringTransformer
    Inherits WebPartTransformer
    Implements IString

    Private _provider As IWebPartRow
    Private _callback As StringCallback

    Private Sub GetRowData(ByVal rowData As Object)
        Dim props As PropertyDescriptorCollection = _provider.Schema

        If ((Not (props Is Nothing)) AndAlso (props.Count > 0) _
          AndAlso (Not (rowData Is Nothing))) Then
            Dim returnValue As String = String.Empty
            For Each prop As PropertyDescriptor In props
                If Not (prop Is props(0)) Then
                    returnValue += ", "
                End If
                returnValue += prop.DisplayName.ToString() + ": " + _
                    prop.GetValue(rowData).ToString()
            Next
            _callback(returnValue)
        Else
            _callback(Nothing)
        End If
    End Sub

    Public Overrides Function Transform(ByVal providerData As Object) As Object
        _provider = CType(providerData, IWebPartRow)
        Return Me
    End Function


    Sub GetStringValue(ByVal callback As StringCallback) _
       Implements IString.GetStringValue
        If (callback Is Nothing) Then
            Throw New ArgumentNullException("callback")
        End If

        If (Not (_provider Is Nothing)) Then
            _callback = callback
            _provider.GetRowData(New RowCallback(AddressOf GetRowData))
        Else
            callback(Nothing)
        End If
    End Sub
End Class

설명

변환기는 호환되지 않는 연결점을 사용하여 두 웹 파트 컨트롤 간에 데이터를 변환하는 데 사용됩니다. 연결점은 서로 다른 인터페이스를 통해 데이터를 제공하거나 사용할 때 호환되지 않습니다. 예를 들어 형식의 공급자 연결 지점을 구현하는 공급자가 형식 IWebPartRow 의 공급자 연결 지점을 IWebPartTable예상하는 소비자에 직접 연결할 수 없습니다. 대신 변환기를 사용하여 두 연결 지점을 연결해야 합니다. 클래스에서 WebPartTransformer 클래스를 파생시켜 사용자 지정된 변환기를 만들 수 있습니다.

특성이 WebPartTransformerAttribute 클래스에 WebPartTransformer 적용됩니다. 공급자 연결 지점의 유형과 변환기가 지원하는 소비자 연결 지점의 유형을 정의합니다. 변환기에서 지원하는 소비자 및 공급자 연결 지점의 형식은 컨트롤 간에 연결하려면 소비자 및 공급자 웹 파트 컨트롤의 연결점과 일치해야 합니다. 런타임에 특정 변환기가 지원하는 연결 지점의 형식은 및 GetProviderType 메서드를 GetConsumerType 통해 검색할 수 있습니다.