SerialPort.DiscardNull プロパティ

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

SerialPort.DiscardNull プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

ポートと受信バッファ間での送信時に、null バイトを無視するかどうかを示す値を取得または設定します。

名前空間: System.IO.Ports
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Property DiscardNull As
 Boolean

Visual Basic (使用法)

Dim instance As SerialPort
Dim value As Boolean

value = instance.DiscardNull

instance.DiscardNull = value

C#

public bool DiscardNull { get;
 set; }

C++

public:
property bool DiscardNull {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_DiscardNull ()

/** @property */
public void set_DiscardNull (boolean value)

JScript

public function get DiscardNull
 () : boolean

public function set DiscardNull
 (value : boolean)

プロパティ値
null バイトを無視する場合は true。それ以外の場合は false。既定値は false です。

例外

例外の種類	条件
IOException	ポートが無効状態です。 または 基本ポートの状態を設定しようとしましたが失敗しました。たとえば、この SerialPort オブジェクトから渡されたパラメータが無効であるなどです。
InvalidOperationException	ストリームが閉じられました。これは、Open メソッドが呼び出されていないか、Close メソッドが呼び出されたことが原因で発生する場合があります。

解説

特にバイナリ伝送の場合は、この値は通常、false に設定する必要があります。このプロパティに true を設定すると、UTF32 および UTF16 でエンコードされたバイトの場合、予測できない結果になる可能性があります。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
SerialPort クラス
SerialPort メンバ
System.IO.Ports 名前空間