ControlDesigner.InvokeTransactedChange メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

一連の変更を、指定されたパラメータを使用して、デザインホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub InvokeTransactedChange
 ( _
    component As IComponent, _
    callback As TransactedChangeCallback, _
    context As Object, _
    description As String _
)

Visual Basic (使用法)

Dim component As IComponent
Dim callback As TransactedChangeCallback
Dim context As Object
Dim description As String

ControlDesigner.InvokeTransactedChange(component, callback, context, description)

public static void InvokeTransactedChange
 (
    IComponent component,
    TransactedChangeCallback callback,
    Object context,
    string description
)

C++

public:
static void InvokeTransactedChange (
    IComponent^ component, 
    TransactedChangeCallback^ callback, 
    Object^ context, 
    String^ description
)

public static void InvokeTransactedChange
 (
    IComponent component, 
    TransactedChangeCallback callback, 
    Object context, 
    String description
)

JScript

public static function InvokeTransactedChange
 (
    component : IComponent, 
    callback : TransactedChangeCallback, 
    context : Object, 
    description : String
)

パラメータ

component: コントロールデザイナに関連付けられたコントロール。

callback: トランザクションの一部としてコントロールデザイナ内で呼び出す関数を表す TransactedChangeCallback。

context: コールバック用の引数を格納しているオブジェクト。

description: トランザクションの完了を許可する効果の説明。これは、ユーザーがトランザクションをキャンセルできるようにするために、デザインホストによって使用されます。

例外

例外の種類	条件
ArgumentNullException	component が null 参照 (Visual Basic では Nothing) です。または callback が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

ArgumentNullException

component が null 参照 (Visual Basic では Nothing) です。

または

callback が null 参照 (Visual Basic では Nothing) です。

解説

InvokeTransactedChange メソッドの実装は、component の Site プロパティによって決定されるデザインホストに、関連付けられているコントロールに変更が発生したことを通知します。また、変更がデザインホストによってキャンセルされていない場合は、指定した context を使用して指定した callback を呼び出して、変更が完了したことをデザインホストに通知します。

デザインホストまたは関連付けられているコントロールにより CheckoutException 例外の静的 Canceled 例外フィールドがスローされた場合、callback が呼び出されずにトランザクションがキャンセルされます。

使用例

Label コントロールおよび TextBox コントロールが指定された単純な複合コントロールを作成する方法を次のコード例に示します。ラベルテキストと、TextBox の Text、Width、および BackColor の各プロパティを設定するためのプロパティも指定しています。関連付けられたコントロールデザイナクラスは、3 つの DesignerActionMethodItem コマンドを作成します。各コマンドはコントロールの 2 つのプロパティを設定します。InvokeTransactedChange メソッドを使用すると、Visual Studio 2005 などのデザインホストの元に戻す機能を使用して、完了済みの各トランザクションを 1 つのユニットとしてロールバックできます。

Visual Basic

Imports Microsoft.VisualBasic
Imports System.Web
Imports System.Web.UI
Imports System.Drawing
Imports System.Collections
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design
Imports System.ComponentModel
Imports System.ComponentModel.Design

Namespace ASPNet.Samples

    ' Create a custom control class with a Label and TextBox
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.InheritanceDemand,
 Name:="FullTrust")> _
    <System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand,
 Name:="FullTrust")> _
    <Designer("ASPNet.Samples.SampleControlDesigner")>
 _
    Public Class SampleControl
        Inherits CompositeControl

        Dim defaultWidth As Integer
 = 150

        Public Sub New()

        End Sub

        ' Create a set of Public properties
        <Bindable(True), DefaultValue(""),
 _
            PersistenceMode(PersistenceMode.Attribute)> _
        Public Property LabelText() As
 String
            Get
                EnsureChildControls()
                Return MyLabel.Text
            End Get
            Set(ByVal value As
 String)
                EnsureChildControls()
                MyLabel.Text = value
            End Set
        End Property

        <Bindable(True), DefaultValue(""),
 _
            PersistenceMode(PersistenceMode.Attribute)> _
        Public Property BoxText() As
 String
            Get
                EnsureChildControls()
                Return MyTextBox.Text
            End Get
            Set(ByVal value As
 String)
                EnsureChildControls()
                MyTextBox.Text = value
            End Set
        End Property

        <Bindable(True), Category("Appearance"),
 _
            PersistenceMode(PersistenceMode.Attribute)> _
        Public Property BoxWidth() As
 Unit
            Get
                EnsureChildControls()
                Return MyTextBox.Width
            End Get
            Set(ByVal value As
 Unit)
                EnsureChildControls()
                MyTextBox.Width = value
            End Set
        End Property

        <Bindable(True), Category("Appearance"),
 _
            PersistenceMode(PersistenceMode.Attribute)> _
        Public Overrides Property
 BackColor() As Color
            Get
                EnsureChildControls()
                Return MyTextBox.BackColor()
            End Get
            Set(ByVal value As
 Color)
                EnsureChildControls()
                MyTextBox.BackColor = value
            End Set
        End Property

        ' Create private properties
        Private ReadOnly Property
 MyTextBox() As TextBox
            Get
                EnsureChildControls()
                Return CType(FindControl("MyTextBox"),
 TextBox)
            End Get
        End Property
        Private ReadOnly Property
 MyLabel() As Label
            Get
                EnsureChildControls()
                Return CType(FindControl("MyLabel"),
 Label)
            End Get
        End Property

        ' Create a Label and a TextBox
        Protected Overrides Sub
 CreateChildControls()
            Controls.Clear()
            MyBase.CreateChildControls()

            ' Create a Label control
            Dim localLabel As New
 Label()
            localLabel.ID = "MyLabel"
            localLabel.Text = localLabel.ID + ": "
            localLabel.EnableViewState = False
            Controls.Add(localLabel)

            ' Create a TextBox control
            Dim localTextBox As New
 TextBox()
            localTextBox.ID = "MyTextBox"
            localTextBox.Width = defaultWidth
            localTextBox.EnableViewState = False
            Controls.Add(localTextBox)
        End Sub
    End Class

    '-----------------------------------------------
    ' Create a designer class for the SampleControl
    <System.Security.Permissions.SecurityPermission(System.Security.Permissions.SecurityAction.Demand,
 Flags:=System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)> _
    Public Class SampleControlDesigner
        Inherits ControlDesigner

        Private sampControl As SampleControl

        ' Constructor
        Public Sub New()
            MyBase.New()
        End Sub

        ' Do not allow resizing; force use of properties to set width
        Public Overrides ReadOnly
 Property AllowResize() As Boolean
            Get
                Return False
            End Get
        End Property

        ' Create a custom ActionLists collection
        Public Overrides ReadOnly
 Property ActionLists() As DesignerActionListCollection
            Get
                ' Create the collection
                Dim lists As New
 DesignerActionListCollection()

                ' Get the base items, if any
                lists.AddRange(MyBase.ActionLists)

                ' Add my own list of actions
                lists.Add(New CustomControlActionList(Me))

                Return lists
            End Get
        End Property

        ' Create an embedded DesignerActionList class
        Private Class CustomControlActionList
            Inherits DesignerActionList

            ' Create private fields
            Private _parent As SampleControlDesigner
            Private _items As DesignerActionItemCollection

            ' Constructor
            Public Sub New(ByVal
 parent As SampleControlDesigner)
                MyBase.New(parent.Component)
                _parent = parent
            End Sub

            ' Create a set of transacted callback methods
            ' Callback for a wide format
            Public Sub FormatWide()
                Dim ctrl As SampleControl =
 CType(_parent.Component, SampleControl)

                ' Create the callback
                Dim toCall As New
 TransactedChangeCallback(AddressOf DoFormat)
                ' Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatWide",
 "Use a wide format")
            End Sub

            ' Callback for the medium format
            Public Sub FormatMedium()
                Dim ctrl As SampleControl =
 CType(_parent.Component, SampleControl)

                ' Create the callback
                Dim toCall As New
 TransactedChangeCallback(AddressOf DoFormat)
                ' Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatMedium",
 "Use a medium format")
            End Sub

            ' Callback for the narrow format
            Public Sub FormatNarrow()
                Dim ctrl As SampleControl =
 CType(_parent.Component, SampleControl)

                ' Create the callback
                Dim toCall As New
 TransactedChangeCallback(AddressOf DoFormat)
                ' Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatNarrow",
 "Use a narrow format")
            End Sub

            ' Get the sorted list of Action items
            Public Overrides Function
 GetSortedActionItems() As DesignerActionItemCollection
                If IsNothing(_items) Then
                    ' Create the collection
                    _items = New DesignerActionItemCollection()

                    ' Add a header to the list
                    _items.Add(New DesignerActionHeaderItem("Select
 a Style:"))

                    ' Add three commands
                    _items.Add(New DesignerActionMethodItem(Me,
 "FormatWide", "Format Wide",
 True))
                    _items.Add(New DesignerActionMethodItem(Me,
 "FormatMedium", "Format Medium",
 True))
                    _items.Add(New DesignerActionMethodItem(Me,
 "FormatNarrow", "Format Narrow",
 True))
                End If

                Return _items
            End Function

            ' Function for the callback to call
            Public Function DoFormat(ByVal
 arg As Object) As Boolean
                ' Get a reference to the designer's associated component
                Dim ctl As SampleControl =
 CType(_parent.ViewControl(), SampleControl)

                ' Get the format name from the arg
                Dim fmt As String
 = CType(arg, String)

                ' Create property descriptors
                Dim widthProp As PropertyDescriptor
 = TypeDescriptor.GetProperties(ctl)("BoxWidth")
                Dim backColorProp As PropertyDescriptor
 = TypeDescriptor.GetProperties(ctl)("BackColor")

                ' For the selected format, set two properties
                Select Case fmt
                    Case "FormatWide"
                        widthProp.SetValue(ctl, Unit.Pixel(250))
                        backColorProp.SetValue(ctl, Color.LightBlue)
                    Case "FormatNarrow"
                        widthProp.SetValue(ctl, Unit.Pixel(100))
                        backColorProp.SetValue(ctl, Color.LightCoral)
                    Case "FormatMedium"
                        widthProp.SetValue(ctl, Unit.Pixel(150))
                        backColorProp.SetValue(ctl, Color.White)
                End Select

                ' Return an indication of success
                Return True

            End Function
        End Class
    End Class

End Namespace

using System;
using System.Web;
using System.Web.UI;
using System.Drawing;
using System.Collections;
using System.Web.UI.WebControls;
using System.Web.UI.Design;
using System.ComponentModel;
using System.ComponentModel.Design;

namespace ASPNet.Samples
{
    // Create a custom control class with a Label and TextBox
    [System.Security.Permissions.PermissionSetAttribute(
        System.Security.Permissions.SecurityAction.InheritanceDemand,
        Name = "FullTrust")]
    [System.Security.Permissions.PermissionSetAttribute(
        System.Security.Permissions.SecurityAction.Demand,
        Name = "FullTrust")]
    [DesignerAttribute(typeof(SampleControlDesigner))]
    public class SampleControl : CompositeControl
    {
        int defaultWidth = 150;

        public SampleControl()
        {
        }

        // Create a set of public properties
        [Browsable(true), Bindable(true), DefaultValue("")
,
            PersistenceMode(PersistenceMode.Attribute)]
        public string LabelText
        {
            get
            {
                EnsureChildControls();
                return MyLabel.Text;
            }
            set
            {
                EnsureChildControls();
                MyLabel.Text = value;
            }
        }

        [Browsable(true), Bindable(true), DefaultValue("")
,
            PersistenceMode(PersistenceMode.Attribute)]
        public string BoxText
        {
            get
            { 
                EnsureChildControls();
                return MyTextBox.Text;
            }
            set
            {
                EnsureChildControls();
                MyTextBox.Text = value;
            }
        }

        [Browsable(true), Bindable(true), Category("Appearance")
,
            PersistenceMode(PersistenceMode.Attribute)]
        public Unit BoxWidth
        {
            get
            {
                EnsureChildControls();
                return MyTextBox.Width;
            }
            set
            {
                EnsureChildControls();
                MyTextBox.Width = value;
            }
        }

        [Browsable(true), Bindable(true), Category("Appearance")
,
            PersistenceMode(PersistenceMode.Attribute)]
        public override Color BackColor
        {
            get
            {
                EnsureChildControls();
                return MyTextBox.BackColor;
           }
            set
            {
                EnsureChildControls();
                MyTextBox.BackColor = value;
            }
        }

        // Create private properties
        private TextBox MyTextBox
        {
            get
            {
                EnsureChildControls();
                return (TextBox)FindControl("MyTextBox");
            }
        }
        private Label MyLabel
        {
            get
            {
                EnsureChildControls();
                return (Label)FindControl("MyLabel");
            }
        }

        // Create a label and a text box.
        protected override void CreateChildControls()
        {
            // Clear the controls
            Controls.Clear();

            // Create a Label control
            Label localLabel = new Label();
            localLabel.EnableViewState = false;
            localLabel.ID = "MyLabel";
            localLabel.Text = localLabel.ID + ": ";
            Controls.Add(localLabel);

            // Create a TextBox control
            TextBox localTextBox = new TextBox();
            localTextBox.ID = "MyTextBox";
            localTextBox.Width = defaultWidth;
            Controls.Add(localTextBox);
        }
    }


    // Create a designer class for the SampleControl
    [System.Security.Permissions.SecurityPermission(
        System.Security.Permissions.SecurityAction.Demand, 
        Flags = System.Security.Permissions.SecurityPermissionFlag.UnmanagedCode)]
    public class SampleControlDesigner : ControlDesigner
    {
        // Constructor
        public SampleControlDesigner() : base()
        {
        }

        // Do not allow resizing; force use of properties to set width
        public override bool AllowResize
        {
            get { return false;
 }
        }

        // Create a custom ActionLists collection
        public override DesignerActionListCollection ActionLists
        {
            get
            {
                // Create the collection
                DesignerActionListCollection actionLists = new
 DesignerActionListCollection();

                // Get the base items, if any
                actionLists.AddRange(base.ActionLists);

                // Add a custom list of actions
                actionLists.Add(new CustomControlActionList(this));

                return actionLists;
            }
        }

        // Create an embedded DesignerActionList class
        private class CustomControlActionList
 : DesignerActionList
        {
            // Create private fields
            private SampleControlDesigner _parent;
            private DesignerActionItemCollection items;

            // Constructor
            public CustomControlActionList(SampleControlDesigner
 parent)
                : base(parent.Component)
            {
                _parent = parent;
            }

            // Create a set of transacted callback methods
            // Callback for the wide format
            public void FormatWide()
            {
                SampleControl ctrl = (SampleControl)_parent.Component;
                
                // Create the callback
                TransactedChangeCallback toCall = new TransactedChangeCallback(DoFormat);
                // Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatWide",
 "Use a wide format");
            }

            // Callback for the medium format
            public void FormatMedium()
            {
                SampleControl ctrl = (SampleControl)_parent.Component;
                
                // Create the callback
                TransactedChangeCallback toCall = new TransactedChangeCallback(DoFormat);
                // Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatMedium",
 "Use a medium format");
            }

            // Callback for the narrow format
            public void FormatNarrow()
            {
                SampleControl ctrl = (SampleControl)_parent.Component;
                
                // Create the callback
                TransactedChangeCallback toCall = new TransactedChangeCallback(DoFormat);
                // Create the transacted change in the control
                ControlDesigner.InvokeTransactedChange(ctrl, toCall, "FormatNarrow",
 "Use a narrow format");
            }

            // Get the sorted list of Action items
            public override DesignerActionItemCollection GetSortedActionItems()
            {
                if (items == null)
                {
                    // Create the collection
                    items = new DesignerActionItemCollection();

                    // Add a header to the list
                    items.Add(new DesignerActionHeaderItem("Select
 a Style:"));

                    // Add three commands
                    items.Add(new DesignerActionMethodItem(this,
 "FormatWide", "Format Wide", true));
                    items.Add(new DesignerActionMethodItem(this,
 "FormatMedium", "Format Medium", true));
                    items.Add(new DesignerActionMethodItem(this,
 "FormatNarrow", "Format Narrow", true));
                }
                return items;
            }

            // Function for the callbacks to call
            public bool DoFormat(object arg)
            {
                // Get a reference to the designer's associated component
                SampleControl ctl = (SampleControl)_parent.Component;

                // Get the format name from the arg
                string fmt = (string)arg;

                // Create property descriptors
                PropertyDescriptor widthProp = TypeDescriptor.GetProperties(ctl)["BoxWidth"];
                PropertyDescriptor backColorProp = TypeDescriptor.GetProperties(ctl)["BackColor"];

                // For the selected format, set two properties
                switch (fmt)
                {
                    case "FormatWide":
                        widthProp.SetValue(ctl, Unit.Pixel(250));
                        backColorProp.SetValue(ctl, Color.LightBlue);
                        break;
                    case "FormatNarrow":
                        widthProp.SetValue(ctl, Unit.Pixel(100));
                        backColorProp.SetValue(ctl, Color.LightCoral);
                        break;
                    case "FormatMedium":
                        widthProp.SetValue(ctl, Unit.Pixel(150));
                        backColorProp.SetValue(ctl, Color.White);
                        break;
                }
                _parent.UpdateDesignTimeHtml();

                // Return an indication of success
                return true;
            }
        }
    }
}

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
CheckoutException
TransactedChangeCallback
その他の技術情報
Web フォームのデザイン時サポート
Web フォームのデザイン時サポート

ControlDesigner.InvokeTransactedChange メソッド (IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub InvokeTransactedChange
 ( _
    serviceProvider As IServiceProvider, _
    component As IComponent, _
    callback As TransactedChangeCallback, _
    context As Object, _
    description As String, _
    member As MemberDescriptor _
)

Visual Basic (使用法)

Dim serviceProvider As IServiceProvider
Dim component As IComponent
Dim callback As TransactedChangeCallback
Dim context As Object
Dim description As String
Dim member As MemberDescriptor

ControlDesigner.InvokeTransactedChange(serviceProvider, component, callback, context,
 description, member)

public static void InvokeTransactedChange
 (
    IServiceProvider serviceProvider,
    IComponent component,
    TransactedChangeCallback callback,
    Object context,
    string description,
    MemberDescriptor member
)

C++

public:
static void InvokeTransactedChange (
    IServiceProvider^ serviceProvider, 
    IComponent^ component, 
    TransactedChangeCallback^ callback, 
    Object^ context, 
    String^ description, 
    MemberDescriptor^ member
)

public static void InvokeTransactedChange
 (
    IServiceProvider serviceProvider, 
    IComponent component, 
    TransactedChangeCallback callback, 
    Object context, 
    String description, 
    MemberDescriptor member
)

JScript

public static function InvokeTransactedChange
 (
    serviceProvider : IServiceProvider, 
    component : IComponent, 
    callback : TransactedChangeCallback, 
    context : Object, 
    description : String, 
    member : MemberDescriptor
)

パラメータ

serviceProvider: 関連付けられているコントロールにコントロールデザイナサービスを提供するデザインホストを表す IServiceProvider。

component: コントロールデザイナに関連付けられたコントロール。

callback: トランザクションの一部としてコントロールデザイナ内で呼び出す関数を表す TransactedChangeCallback。

context: コールバック用の引数を格納しているオブジェクト。

description: トランザクションの完了を許可する効果の説明。これは、ユーザーがトランザクションをキャンセルできるようにするために、デザインホストによって使用されます。

member: トランザクションの一部として呼び出される関連コントロールのメンバを記述する MemberDescriptor (通常は EventDescriptor または PropertyDescriptor)。

例外

例外の種類	条件
ArgumentNullException	component が null 参照 (Visual Basic では Nothing) です。または callback が null 参照 (Visual Basic では Nothing) です。または serviceProvider が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

ArgumentNullException

component が null 参照 (Visual Basic では Nothing) です。

または

callback が null 参照 (Visual Basic では Nothing) です。

または

serviceProvider が null 参照 (Visual Basic では Nothing) です。

解説

InvokeTransactedChange メソッドの実装は、serviceProvider によって表されるデザインホストに、関連付けられているコントロールの指定した member (プロパティまたはメソッド) に変更が発生したことを通知します。また、変更がデザインホストによってキャンセルされていない場合は、指定した context を引数として使用して指定した callback を呼び出して、変更が完了したことをデザインホストに通知します。

使用例

コード例については、「InvokeTransactedChange」を参照してください。

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
IServiceProvider
EventDescriptor
PropertyDescriptor
TransactedChangeCallback
その他の技術情報
Web フォームのデザイン時サポート

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

名前空間: System.Web.UI.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Shared Sub InvokeTransactedChange
 ( _
    component As IComponent, _
    callback As TransactedChangeCallback, _
    context As Object, _
    description As String, _
    member As MemberDescriptor _
)

Visual Basic (使用法)

Dim component As IComponent
Dim callback As TransactedChangeCallback
Dim context As Object
Dim description As String
Dim member As MemberDescriptor

ControlDesigner.InvokeTransactedChange(component, callback, context, description,
 member)

public static void InvokeTransactedChange
 (
    IComponent component,
    TransactedChangeCallback callback,
    Object context,
    string description,
    MemberDescriptor member
)

C++

public:
static void InvokeTransactedChange (
    IComponent^ component, 
    TransactedChangeCallback^ callback, 
    Object^ context, 
    String^ description, 
    MemberDescriptor^ member
)

public static void InvokeTransactedChange
 (
    IComponent component, 
    TransactedChangeCallback callback, 
    Object context, 
    String description, 
    MemberDescriptor member
)

JScript

public static function InvokeTransactedChange
 (
    component : IComponent, 
    callback : TransactedChangeCallback, 
    context : Object, 
    description : String, 
    member : MemberDescriptor
)

パラメータ

component: コントロールデザイナに関連付けられたコントロール。

callback: トランザクションの一部としてコントロールデザイナ内で呼び出す関数を表す TransactedChangeCallback。

context: コールバック用の引数を格納しているオブジェクト。

description: トランザクションの完了を許可する効果の説明。これは、ユーザーがトランザクションをキャンセルできるようにするために、デザインホストによって使用されます。

member: トランザクションの一部として呼び出される関連付けられたコントロールのメンバを記述する MemberDescriptor (通常は EventDescriptor または PropertyDescriptor)。

例外

例外の種類	条件
ArgumentNullException	component が null 参照 (Visual Basic では Nothing) です。または callback が null 参照 (Visual Basic では Nothing) です。

例外の種類

条件

ArgumentNullException

component が null 参照 (Visual Basic では Nothing) です。

または

callback が null 参照 (Visual Basic では Nothing) です。

解説

InvokeTransactedChange メソッドの実装は、component の Site プロパティによって決定されるデザインホストに、関連付けられているコントロールの指定した member (プロパティまたはメソッド) に変更が発生したことを通知します。また、変更がデザインホストによってキャンセルされていない場合は、指定した context を引数として使用して指定した callback を呼び出して、変更が完了したことをデザインホストに通知します。

使用例

コード例については、「InvokeTransactedChange」を参照してください。

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ControlDesigner クラス
ControlDesigner メンバ
System.Web.UI.Design 名前空間
EventDescriptor
PropertyDescriptor
TransactedChangeCallback
その他の技術情報
Web フォームのデザイン時サポート

ControlDesigner.InvokeTransactedChange メソッド

一連の変更を、指定されたパラメータを使用して、デザインホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。
オーバーロードの一覧

名前	説明
ControlDesigner.InvokeTransactedChange (IComponent, TransactedChangeCallback, Object, String)	一連の変更を、指定されたパラメータを使用して、デザインホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。
ControlDesigner.InvokeTransactedChange (IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)	一連の変更を、指定されたパラメータを使用して、デザインホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。
ControlDesigner.InvokeTransactedChange (IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)	一連の変更を、指定されたパラメータを使用して、デザインホストが持つ元に戻す機能によってまとめてロールバックできるトランザクションに、ラップします。

参照

その他の技術情報

Web フォームのデザイン時サポート
Web フォームのデザイン時サポート

Web フォームのデザイン時サポート

ControlDesigner.InvokeTransactedChange メソッドとは？わかりやすく解説

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String)

ControlDesigner.InvokeTransactedChange メソッド (IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

ControlDesigner.InvokeTransactedChange メソッド

関連項目

その他の技術情報

「ControlDesigner.InvokeTransactedChange メソッド」の関連用語


	© 2025 Microsoft.All rights reserved.

ControlDesigner.InvokeTransactedChange メソッドとは？ わかりやすく解説

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String)

ControlDesigner.InvokeTransactedChange メソッド (IServiceProvider, IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

ControlDesigner.InvokeTransactedChange メソッド (IComponent, TransactedChangeCallback, Object, String, MemberDescriptor)

ControlDesigner.InvokeTransactedChange メソッド

関連項目

その他の技術情報

急上昇のことば

「ControlDesigner.InvokeTransactedChange メソッド」の関連用語

ControlDesigner.InvokeTransactedChange メソッドとは？わかりやすく解説