C# と VB.NET の質問掲示板

■No63372 (Unripe01 さん) に返信
> となり、Captionに"でふぉるとばりゅ"が反映されない。
Caption プロパティは、string ではなく Label なのですよね。
その Label の Text は、予め "でふぉるとばりゅ" にしてありますか?


> DefaultValueAttribute Constructor ( String )を使う事が誤り？
そもそも「Label 型」のメンバーに "でふぉるとばりゅ" という「文字列」は渡せないと思います。

文字列で指定したいなら、内包コントロールを直接返すプロパティにはせず、
内包コントロールの Text プロパティのみを返すプロパティとするべきかと。
  
 //public Label Caption {
 //  get { return this._Label; }
 //  set { … }
 //}

   public string Caption {
     get { return this._Label.Text; }
     set { … }
   }


また、現在のコードは Caption プロパティが ReadOnly ではなく、
getter と setter の両方を兼ね備えていますが、これだと利用する側が
　this.textBoxEX1.Caption = this.label1;
などのようにして、別のコントロールに変更できてしまいます。
本当に setter まで必要なのでしょうか?

もし、Caption プロパティ(Label型)の内容を外部から書き換えるために、
　this.textBoxEX1.Caption.Text = "別の文字列";
などの表現を使いたいのだけならば、getter だけで充分ですよね。


> DefaultValueAttribute Constructor ( Type, String )を使うべき？
DefaultValueAttribute というのは、以下の 2 つの働きがあります。

(1) *.designer.cs への自動生成コードにおいて、規定値のままならば
　プロパティ設定コードを生成しない(シリアライズを省略する)。

(2) デザイン時にプロパティが変更された後(プロパティが太字で表示されているとき)に、
　その項目を右クリック→リセットされた場合のリセット値として利用される。


もしも 単純な DefaultValueAttribute だけでは 表現しきれないような
プロパティの場合(たとえば Label 型を返すプロパティなど)においては、
そのプロパティに DefaultValueAttribute 属性を付けるのではなく、その代わりに
ShouldSerialize{propName}メソッド/Reset{propName}メソッドを実装します。
(これらのメソッドは、private にしても public にしても構いません)
http://msdn.microsoft.com/ja-jp/library/53b8022e.aspx



以下、本題とは関係ないところで。

> Vitual Studio 2010にて
ここはスペルミスなので見なかったことにして…。

> 利用言語：FrameWork 4.0 （C#）
FrameWork ではなく
Framework ですね。

■No63377 (Unripe01 さん) に返信
> たくさんのご指摘、ありがとうございます。
コードを掲載するときは、投稿モードを[図表モード]に変更してください。
通常モードのまま送信すると、インデントが失われてしまいますので。


> private Label _Label = new Label();
ここで Label を生成していますが、Text や Size を設定している箇所が見当たりませんし、
そもそも Controls.Add すらしていないように見えます。
ここで new した Label を表示させるためのコードはどこにありますか?


> 特にCaptionのプロパティ設定に関しては、色々とコードを変更していた折、
Caption プロパティを string 型と Label 型のどちらにするかという話に戻りますが、
Label の生成・管理・破棄を TextBoxEX が担うのであれば、string のみの公開の方が良いですし、
Label を利用者側から提供する場合には、当初の通り、Label 型で公開した方が良いでしょう。



> Form上にTextBoxとLabelが１セットと意識している実装が元々あり、

UserControl を用意し、その中に TextBox と Label を内包させるような場合には、
Controls.Add は UserControl のデザイン時に行っておけば済みます。


一方、TextBox 継承クラスとする場合は、Label は Form上に貼ることになるので、

(案1) Label を管理するのは TextBoxEX 側とし、親フォームの特定の箇所に
　Label を Controls.Add / Remove するためのコードを用意する。

(案2) Label を管理するのは Form 側として、Label インスタンスを受け取るための
　　プロパティを用意しておく。

などの対処が必要です。(レイアウトの自由度では案2の方が良いかも?)

いずれにせよ、この場合にはプリミティブ型ではなく Label 型での操作となるため、
DefaultValueAttribute の出番はありません。もしも DefaultValueAttribute を
使うのであれば、それは別のプロパティとして用意することになるでしょう。

-----------------
  // 案2 パターンで実装した場合のイメージコード

  public Label CaptionLabel {
    get { return this._CaptionLabel; }
    set {
      if (value != null) value.Text = "でふぉるとばりゅ";
      this._CaptionLabel = value;
    }
  }

  [DefaultValue("でふぉるとばりゅ")]
  public string Caption {
    get { return (CaptionLabel == null) ? null : CaptionLabel.Text; }
    set { if (CaptionLabel != null) CaptionLabel.Text = value; }
  }
-----------------


なお、上記コードは シリアライズ/デシリアライズの順を考慮していないため、
「ラベル割り当て→ テキスト割り当て」の順でデシリアライズされた場合には復元できますが、
「テキスト割り当て→ ラベル割り当て」の順でデシリアライズされると復元できません。

そのためこの場合には、ISupportInitialize インターフェイスも実装した方が良いでしょう。

■No63372, No63386, No63387 (Unripe01 さん) に返信
> ※魔界の仮面弁士　からのご指摘があり、コード修正しています。
敬称略。

> public TextBoxEX()
> {
>     InitializeComponent();
> }
手元の環境で継承コントロールを作ってみたのですが、上記のコード部分が
自動生成されることはありませんでした。
(partial class の片割れとなる TextBoxEX.designer.cs も生成されない)

そちらでは、どのようにして生成されたのでしょうか?


なお、当方での作り方はこんな感じです。

(1) 新規プロジェクトを作成(WindowsApplication1)

(2) プロジェクトに、新規クラス TextBoxEX.cs を追加する。
　この時点のコードは下記の状態。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;

namespace WindowsFormsApplication1
{
    class TextBoxEX
    {
    }
}

(3) 上記コードをバッサリ削除して、No63372 の「継承コントロールクラス」の
　コードに入れ替える。

(4) このままだとエラーになるので、先頭に以下の using を追加。

using System.Windows.Forms;
using System.ComponentModel;

(5) InitializeComponent が無いと言われるので、コンストラクタ自体を
　まるごとコメントアウトする。

  // public TextBoxEX()
  // {
  //     InitializeComponent();
  // }

(6) ここで一度ソースコードウィンドウをすべて閉じてから
　WindowsApplication1 をビルド。その後、ソリューションエクスプローラから
　TextBoxEX.cs をダブルクリックすると、TextBoxEX.cs のデザイン画面が開くので、
　[ここをクリックするとコードビューに切り替わります]をクリック。

(7) この段階では、ソースコードに変化なし。
　InitializeComponent も コンストラクタも生成されていない。

(8) TextBoxEX のデザイン画面に、ツールボックスから Label をドロップしてきて、
　label1 が貼りついた状態にする。この状態で保存すると TextBoxEX.resx が出現。

(9) あらためて TextBoxEX.cs を見ると、private void InitializeComponent() が
　生成されていた。しかし、コンストラクタは存在しないまま。

(10) TextBoxEX に張り付いた label1 を削除してみるが、やはり
　InitializeComponent を呼び出すコンストラクタが自動生成されることは無かった。



> this.txtKensuEnd.Caption = global::sampleApp.app.resource.sample1.sampleValue1;
上記の手順(1)〜(7)を踏んで作った TextBoxEX.cs (TextBoxEX.resx は無し)を
Form1 に貼り付けてみたところ、一応、
  this.textBoxEX1.Caption = global::WindowsFormsApplication1.Properties.Resources.sampleValue2;
という状態にはなりました。でも、似ているけれど全然違いますね…。
(Unripe01 さんのコードでは小文字単数形の「resource」になったと書かれているが、
 こちらは、大文字始まり複数形の「Resources」になっている)


う〜ん。何が違うのでしょうね。


> となってしまう件については、まったく解決のめどが立っていません。
> リビルドを繰り返したり、TextBoxEXを再作成するなどを繰り返ししたところ、発生しなくなったので
> 「何かが壊れていた」と結論づけて終わりたいと思います。

とりあえず、上記手順(3) の段階のコードで、
    // private Label _Label = new Label();
    private Label _Label = new Label() { Text = "でふぉるとばりゅ" };
に変更し、さらにCaption プロパティの getter を下記のように変更してみました。

  get
  {
      //return this.Label.Text;
      if (this.Label != null && !this.Label.IsDisposed
          /* && this.Label.IsHandleCreated */)
      {
          return this.Label.Text;
      }
      else
      {
          return null;
      }
  }


この場合は、「.Caption = 〜.sampleValue1;」形式のデザイナコードにはならず、
以下のような結果になりました。

・初期値(でふぉるとばりゅ)の場合は、デザイナコードに Caption 設定の行が作られない。

・Form1デザイナで Caption プロパティを変更した場合には、
　「this.textBoxEX1.Caption = "あたらしい値だよ!";」
　形式のデザイナコードが生成された。


まぁ、実際にはこんなコードではマズイでしょうけれども。




> リセットされた場合のリセット値で、
> コントロールを張り付けた時のデフォルト値ではないということが分かっておりませんでした。
デフォルト値であっていますよ。

注意しなければならないのは、DefaultValueAttribute というものは、
『既定値』をデザイナに伝えるためのものであって、
『初期値』を設定するものではない、という点でしょうか。

最初のコードは、「初期値 = ""」、「既定値 = "でふぉるとばりゅ"」ですね。


> シリアライズ、デシリアライズについては考慮不要のため、問題ないです。
Caption プロパティにデザイナがアクセスする際に、Label プロパティが
適切に生成されているのか、生成タイミングが気になるところ。

■No63389 (魔界の仮面弁士 さん) に返信

> 敬称略。
大変失礼しました。修正しました。

> (partial class の片割れとなる TextBoxEX.designer.cs も生成されない)
> そちらでは、どのようにして生成されたのでしょうか?
当方では、
（1）新規プロジェクトを作成(WindowsApplication1)
（2）プロジェクトに、ユーザーコントロールを追加を選択（TextBoxEXを作成⇒この時点で InitializeComponent が作成される）
（3）2の時点ではUserControlを継承しているので、継承元をTextBoxに変更
（4）this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;となっている行を削除
　参考にしたURL
　　・チュートリアル : Visual C# による Windows フォーム コントロールからの継承
　　http://msdn.microsoft.com/ja-jp/library/5h0k2e6x(v=vs.80).aspx
上記手順で作成しています。


> 上記の手順(1)〜(7)を踏んで作った TextBoxEX.cs (TextBoxEX.resx は無し)を
> Form1 に貼り付けてみたところ、一応、
>   this.textBoxEX1.Caption = global::WindowsFormsApplication1.Properties.Resources.sampleValue2;
> という状態にはなりました。でも、似ているけれど全然違いますね…。
> (Unripe01 さんのコードでは小文字単数形の「resource」になったと書かれているが、
>  こちらは、大文字始まり複数形の「Resources」になっている)

魔界の仮面弁士様と同じやり方でサンプルプロジェクトを作成しましたが・・・
>   this.textBoxEX1.Caption = global::WindowsFormsApplication1.Properties.Resources.sampleValue2;
にはならず、
this.textBoxEX1.Caption = ""
となりました。さらに謎が深まりました・・・

this.textBoxEX1.Caption = global::~~　となるプロジェクトの継承コントロールの作成方法については
申し訳ないですが不明です。
global::〜〜が再現された事については驚きです。「おかしな動き」だと思っていたので。
ですが、当方のものと似てるけど違いますね・・・
おそらく
global::WindowsFormsApplication1.Properties.Resources.
というパスは存在するでしょうし、sampleValue2も生成されてるかと思いますが、
こちらのglobal::は、存在もしないパスです。
ですから、Formに張り付けた時点でコンパイルエラーになります。

> この場合は、「.Caption = 〜.sampleValue1;」形式のデザイナコードにはならず、
> 以下のような結果になりました。
> まぁ、実際にはこんなコードではマズイでしょうけれども。
> 注意しなければならないのは、DefaultValueAttribute というものは、
> 『既定値』をデザイナに伝えるためのものであって、
> 『初期値』を設定するものではない、という点でしょうか。

同じく、確認しました。
既定値と初期値の考えを改めて理解させていただきました。
ありがとうございます。

>>シリアライズ、デシリアライズについては考慮不要のため、問題ないです。
> Caption プロパティにデザイナがアクセスする際に、Label プロパティが
> 適切に生成されているのか、生成タイミングが気になるところ。

なるほど。。。念のためLabelの宣言を上にしてましたが、寝耳に水ですね。
「適切」かどうか微妙です。
一方で、CaptionがLabelへアクセスする時点での保証は
上記new部分をコンストラクタに実装してやれば大丈夫な気もします。
しかし、プロパティの設定となると、デザイナ任せでは

>上記コードは シリアライズ/デシリアライズの順を考慮していないため、

の通り、Captionの行生成⇒Labelの行生成が十分にありえますね。
考慮できておりませんでした。ありがとうございます。

根本原因の理解⇒
たぶん、プロジェクトファイルがおかしくなってる。（仮説）
新規生成したプロジェクトでは再現しない。（理由）
でも、おかしくなっている場所が分からない（検討内容）
にはなっていませんが・・・

こういった問題が発生した時の解としては

１．継承コントロールのプロパティを
private Label _Label = new Label() { Text = "でふぉるとばりゅ" };
に変更する。

２．さらにCaption プロパティの getter を下記のように変更。
  get
  {
      //return this.Label.Text;
      if (this.Label != null && !this.Label.IsDisposed
          /* && this.Label.IsHandleCreated */)
      {
          return this.Label.Text;
      }
      else
      {
          return null;
      }
  }

上記で解消することが分かりましたので
解決とさせていただきたいと思います。

色々と検証いただきありがとうございます。
何か進展ありましたが、別途ご報告させていただきます。