翔星 Be ランド日記

• シンプルなコンテキストメニュー
• 左クリックでもオープンするコンテキストメニュー
• テキストボックスデフォルトのコンテキストメニューを非表示にする
• リストボックスのアイテムのみ右クリックでオープンするコンテキストメニュー
• 動的に状態を制御するコンテキストメニュー
• 動的にアイテム数を制御するコンテキストメニュー

シンプルなコンテキストメニュー

<Label Content="シンプルなコンテキストメニュー：右クリックでオープンする（左クリックではオープンしない）" >
<Label.ContextMenu>
    <ContextMenu>
        <MenuItem Header="シンプルラベルメニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="シンプルラベルメニュー 1" />     
  （省略...）
        </MenuItem>
    </ContextMenu>
</Label.ContextMenu>
</Label>

左クリックでもオープンするコンテキストメニュー

<Button Name="ButtonLeftSample" Content="左クリックでもオープンするコンテキストメニュー（コントロールのイベントを捕捉してオープンする）" Margin="0,10,0,0" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="Click">
        <behaviors:ChangePropertyAction TargetObject="{Binding ContextMenu, ElementName=ButtonLeftSample}" PropertyName="IsOpen" Value="True"/>
        <behaviors:ChangePropertyAction TargetObject="{Binding ContextMenu, ElementName=ButtonLeftSample}" PropertyName="PlacementTarget" Value="{Binding ElementName=ButtonLeftSample, Mode=OneWay}"/>
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Button.ContextMenu>
    <ContextMenu >
        <MenuItem Header="左クリックメニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="左クリックメニュー 1" />
        <MenuItem Header="左クリックメニュー 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="左クリックメニュー 2" />
    </ContextMenu>
</Button.ContextMenu>
</Button>

テキストボックスデフォルトのコンテキストメニューを非表示にする

<TextBox Width="100" Text="非表示" VerticalAlignment="Center" ContextMenu="{x:Null}" />

リストボックスのアイテムのみ右クリックでオープンするコンテキストメニュー

<ListBox ItemsSource="{Binding NarrowListBoxItems}" Width="290" >
    <ListBox.ItemContainerStyle>
        <Style TargetType="ListBoxItem" >
            <Setter Property="Tag" Value="{Binding RelativeSource={RelativeSource AncestorType=Window}, Path=DataContext}"/>
            <Setter Property="ContextMenu">
                <Setter.Value>
                    <ContextMenu DataContext="{Binding Path=PlacementTarget.Tag, RelativeSource={RelativeSource Self}}">
                        <MenuItem Header="アイテムのみ ListBox メニュー 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="アイテムのみ ListBox メニュー 1" />
                        <MenuItem Header="アイテムのみ ListBox メニュー 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="アイテムのみ ListBox メニュー 2" />
                    </ContextMenu>
                </Setter.Value>
            </Setter>
        </Style>
    </ListBox.ItemContainerStyle>
</ListBox>

動的に状態を制御するコンテキストメニュー

<Label Content="動的に状態を制御するコンテキストメニュー" Margin="0,10,0,0" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="ContextMenuOpening">
        <l:LivetCallMethodAction MethodName="PrepareDynamicStateContextMenu" MethodTarget="{Binding}" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Label.ContextMenu>
    <ContextMenu>
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 1" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 1" />
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 2" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 2" IsEnabled="{Binding IsDynamicStateMenuItemEnabled}" />
        <MenuItem Header="{Binding MenuItemHeaderDynamicState}" HeaderStringFormat="{}{0} 3" Command="{Binding MenuItemTestClickedCommand}" CommandParameter="動的状態制御メニュー 3" Visibility="{Binding DynamicStateMenuItemVisibility}"/>
    </ContextMenu>
</Label.ContextMenu>
</Label>

動的にアイテム数を制御するコンテキストメニュー

<Label Content="動的にアイテム数を制御するコンテキストメニュー" >
<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="ContextMenuOpening">
        <l:LivetCallMethodAction MethodName="PrepareDynamicItemsContextMenu" MethodTarget="{Binding}" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>
<Label.ContextMenu>
    <ContextMenu ItemsSource="{Binding DynamicMenuItems}" />
</Label.ContextMenu>
</Label>

（補足）

本記事は、以前の記事を時代に合わせて改訂したものです。

使用するパッケージ

Microsoft.EntityFrameworkCore.Sqlite のインストール

テーブル構造定義クラスの作成

フィールド名	型	NULL	備考
test_id	整数	不可	連番、主キー
test_name	文字列	不可	氏名、インデックス作成、ユニーク制約
test_height	浮動小数	可	身長

[Table("t_test")]
[Index(nameof(Name), IsUnique = true)]
internal class TTestData
{
    // ID
    [Key]
    [Column("test_id")]
    public Int32 Id { get; set; }

    // 氏名
    [Column("test_name")]
    public String Name { get; set; } = String.Empty;

    // 身長
    [Column("test_height")]
    public Double? Height { get; set; }
}

コンテキストクラスの作成

internal class TestContext : DbContext
{
    // テストテーブル
    public DbSet<TTestData> TestData { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        SqliteConnectionStringBuilder stringBuilder = new()
        {
            DataSource = "Test.sqlite3",
        };
        using SqliteConnection sqliteConnection = new(stringBuilder.ToString());
        optionsBuilder.UseSqlite(sqliteConnection);
    }
}

データベースファイルの作成

using TestContext testContext = new();
testContext.Database.EnsureCreated();

レコードの挿入

testContext.TestData.Add(new TTestData { Name = "Fukada Kyoko" });
testContext.TestData.Add(new TTestData { Name = "Eda Ha", Height = 159.0 });
testContext.SaveChanges();

Add() した時点では実際にはデータベースファイルには追加されず、SaveChanges() でまとめて追加されます。

文字列で SQL を記述する必要がないため、タイプミスによるエラーが発生せず、また、Visual Studio の各種サジェストによる支援も受けられます。確実・簡単にデータベースを操作できます。

レコードの検索

IQueryable<TTestData> queryResult = testContext.TestData.Where(x => x.Name == "Eda Ha" || x.Height < 150.0).OrderBy(x => x.Height);

Where(x => x.Name.Contains("a"))

Where(x => x.Name.Contains("a", StringComparison.OrdinalIgnoreCase))

Where(x => EF.Functions.Like(x.Name, $"%a%"))

レコードの削除

IQueryable<TTestData> queryResult = testContext.TestData.Where(x => x.Height == null || x.Height < 150.0);
testContext.TestData.RemoveRange(queryResult);
testContext.SaveChanges();

レコードの更新

サンプルコードについて

インメモリデータベース

ジャーナルモード

更新履歴

アプリ更新編　目次

更新版アプリのパッケージ作成

更新申請

申請ページが更新したページだけ「更新済み」となるので、そのまま「Microsoft Store に提出」ボタンをクリックすれば、更新版を申請できます。

ストアからの更新

所感

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

関連記事

ストア配布編　目次

申請

システム要件もそれっぽいのを入れておきます。





作成したアプリパッケージ（パッケージプロジェクトフォルダーの中の AppPackages フォルダーにある msixupload ファイル）をドラッグ＆ドロップしてアップロードします。

デバイスファミリの利用可否のところで、どの Windows で使えるかを指定します。今回はノーマルな Windows のみにしておきました。








申請オプションは特に変更しなくて大丈夫です（タイミングを遅らせることもできます）。

認定待ち

コラム：認定作業は平日のみか？

ストアからのダウンロード

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

関連記事

更新履歴

アプリ作成編　目次

準備

（メモ）

非 UWP アプリを UWP 風にしてストア配布できるようにする仕組みを Desktop Bridge と呼ぶようです。

Desktop Bridge のやり方はいくつかあり、昔は Desktop App Converter(DAC) を使っていましたが、その後継が MSIX Packaging Tools のようです。

WPF アプリ作成

    <Grid>
        <Label Content="Ver 1" FontSize="50" HorizontalAlignment="Center" VerticalAlignment="Center" />
    </Grid>

高 DPI 対応宣言

ソリューションエクスプローラーのプロジェクトを右クリックし、［追加 → 新しい項目］を選びます。

  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware>
      <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2, PerMonitor</dpiAwareness>
    </windowsSettings>
  </application>

64 ビット設定

MSIX パッケージプロジェクトの追加

ロゴの作成

アプリケーション名の予約（簡単な方法）

（補足）
こちらは Visual Studio から簡単に予約する方法です。

パッケージ名にこだわりたい場合は次節をご覧ください。

アプリケーション名の予約（パッケージ名にこだわる方法）

MSIX パッケージ作成

パッケージの検証

C:\Users\（管理者ユーザー）\AppData\Local\Microsoft\AppCertKit\ValidationResult.htm

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

更新履歴

開発者登録編　目次

メモ：なぜ Microsoft Store？

必要なもの

パートナー登録

WPF アプリを Microsoft Store に申請・登録する（全 4 回）

大まかな手順

STEP 1：XAML 作成

STEP 2：動的読み込み

注意点

xmlns:vm="clr-namespace:TestXamlReader.ViewModels"

xmlns:vm="clr-namespace:TestXamlReader.ViewModels;assembly=TestXamlReader"

（補足）

別のプロジェクトで、assembly を指定するとビルド時に MC3074 エラー「タグ 'XXX' は、XML 名前空間 'clr-namespace:YYY;assembly=ZZZ' にありません。」が発生したことがあった。

対処方法が分からず、xaml 上では assembly を指定せず、実行時に文字列置換で assembly 指定を追加することで凌いだことがある。

xmlns:dd="urn:gong-wpf-dragdrop"

xmlns:dd="clr-namespace:GongSolutions.Wpf.DragDrop;assembly=GongSolutions.Wpf.DragDrop"

await SomeAsync();

～Async() の中ではひたすら Task.Run() すれば UI はフリーズしないが、他の async を呼ぶために async にしている場合は、その他のコードが重くないか考える必要がある。

ActualWidth はバインドできない

Livet で楽ちん

<behaviors:Interaction.Triggers>
    <behaviors:EventTrigger EventName="SizeChanged">
        <l:WindowSetStateToSourceAction Source="{Binding ActualHeight, Mode=TwoWay}" Property="ActualHeight" />
    </behaviors:EventTrigger>
</behaviors:Interaction.Triggers>

今回はビヘイビアについて少し考えてみるのが目的なので、ActualWidth についてビヘイビアを自作する。

ビヘイビアで ActualWidth をバインド可能にする

public static readonly DependencyProperty ActualWidthProperty =
        DependencyProperty.Register(nameof(ActualWidth), typeof(Double), typeof(WindowBindingSupportBehavior),
        new FrameworkPropertyMetadata(0.0, FrameworkPropertyMetadataOptions.BindsTwoWayByDefault));

public Double ActualWidth
{
    get => (Double)GetValue(ActualWidthProperty);
    set => SetValue(ActualWidthProperty, value);
}

DependencyProperty.Register() の第二引数で変数の型、第三引数でビヘイビアクラスを指定する。第四引数の FrameworkPropertyMetadata 内でプロパティーのデフォルト値を指定する。

依存プロパティー登録により ActualWidth のバインドが可能となったので、次は、ActualWidth の値を更新して有用な値にするところ。

ビヘイビアで IsActive をバインド可能にする

private static void SourceIsActiveChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    if ((obj is not WindowBindingSupportBehavior thisObject) || thisObject.AssociatedObject == null)
    {
        return;
    }

    if ((Boolean)args.NewValue)
    {
        thisObject.AssociatedObject.Activate();
    }
}

対象のフレームワーク

NETSDK1137 警告

NETSDK1137 Microsoft.NET.Sdk.WindowsDesktop SDK を使用する必要はなくなりました。
ルート プロジェクト要素の SDK 属性を 'Microsoft.NET.Sdk' に変更することをご検討ください。

単一ファイルの作成

<IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>

<DebugType>embedded</DebugType>

null 安全とは

コード例

String str = null;
String low = str.ToLower();

String str = "HOGE";
String low = str.ToLower();

String? str = null;
String? low = str?.ToLower();

いくつかコードを書いてみた感想

private void Func(Object? sender)
{
    if (sender is UIElement element)
    {
        element.AllowDrop = true;
    }
}

hoge.ShowWarning();

hoge?.ShowWarning();

革命は 1 日にして成らず

String[] strs = new String[3];

気になったこと

if (str != null)
{
    str.ToLower();
}

目次

やりたいこと

サンプルコード

実装の基本方針

プログラムの解説

WPF で動画を扱うメリット

WPF で動画を扱うデメリット

スクリーンショットの動画

	フォーム ゆかりすたー Ver 7.51	WPF / コードビハインド ゆかりすたー METEOR Ver 1.50	WPF / MVVM ゆかりすたー METEOR Ver 2.02
保守容易性指数	82	84	86
サイクロマティック複雑度	3888	3933	4480
継承の深さ	7	9	9
クラス結合	431	466	465
コード行	12498	9685	9333

保守容易性指数

	元の WPF / MVVM	コントロール削除
保守容易性指数	91	91
サイクロマティック複雑度	1	1
継承の深さ	9	9
クラス結合	7	2
コード行	2	2

サイクロマティック複雑度

継承の深さ

クラス結合

コード行

まとめ

ViewModel から直接 View を参照してしまう

<i:EventTrigger EventName="ContentRendered">
    <l:LivetCallMethodAction MethodTarget="{Binding}" MethodName="Initialize"/>
    <l:LivetCallMethodAction MethodTarget="{Binding}" MethodName="Initialize2" MethodParameter="{Binding ElementName=MyWindow}"/>
</i:EventTrigger>

public void Initialize2(Object oParam)
{
    Debug.WriteLine("Initialize2() param type: " + oParam?.GetType().ToString());
}

• テーブル構造
• 共通カラムの操作
• 継承でやってはどうか？
• サンプルコード
• サンプルコードアプリの使い方
• 参考資料
• 更新履歴

テーブル構造

public interface IFoodData
{
    // ID
    Int32 Id { get; set; }

    // 名前
    String Name { get; set; }
}

[Table(Name = "t_fruit")]
public class TFruitData : IFoodData
{
    // --------------------------------------------------------------------
    // IFoodData 実装
    // --------------------------------------------------------------------

    // ID
    [Column(Name = "fruit_id", DbType = LinqUtils.DB_TYPE_INT32, CanBeNull = false, IsPrimaryKey = true)]
    public Int32 Id { get; set; }

    // 名前
    [Column(Name = "fruit_name", DbType = LinqUtils.DB_TYPE_STRING, CanBeNull = false)]
    public String Name { get; set; }

    // --------------------------------------------------------------------
    // TFruitData 独自項目
    // --------------------------------------------------------------------

    // 色
    [Column(Name = "fruit_color", DbType = LinqUtils.DB_TYPE_STRING, CanBeNull = true)]
    public String Color { get; set; }
}

のようにする。

共通カラムの操作

private void QueryFoodByName<T>(String oKeyword) where T : class, IFoodData
{
    Console.WriteLine(LinqUtils.TableName(typeof(T)) + " 内で名前に「" + oKeyword + "」を含むレコードを検索");
    using (SQLiteConnection aConnection = CreateDatabaseConnection(DB_NAME_GENERIC))
    using (DataContext aContext = new DataContext(aConnection))
    {
        Table<T> aTableTest = aContext.GetTable<T>();
        IQueryable<T> aQueryResult =
                from x in aTableTest
                where x.Name.Contains(oKeyword)
                select x;
        Console.WriteLine("検索結果：" + aQueryResult.Count() + " 件");
        foreach (T aRecord in aQueryResult)
        {
            Console.WriteLine(aRecord.Name);
        }
    }
}

QueryFoodByName<TFruitData>("hoge");
QueryFoodByName<TMeatData>("fuga");

継承でやってはどうか？

サンプルコード

サンプルコードは GitHub にて。

サンプルコードアプリの使い方

なお、サンプルコードアプリには基本操作の欄もあるが、こちらについては「C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）【改訂版】」を参照。

参考資料

• C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）【改訂版】

更新履歴

WPF のほうが良いところ

• UI コントロールのフロー配置
• テーマで見た目を変えられる
• データと UI の分離と関連付け
• データグリッドがスマート
• 動画系の機能が強化されている

フォームのほうが良いところ

• UI コントールの配置が簡単・速い
• 非ビジュアルコントロールもマウスで配置可能
• 基本的な機能がきちんと揃っている
• マイナーな機能も結構揃ってる
• 勉強量が WPF より少なくて済む
• 日本語の情報が豊富
• WPF は英語含めても情報が見当たらない

まとめ

• まとめ
• 追記：MVVM について
• 蛇足：個人的な好み

UI コントロールのフロー配置

テーマで見た目を変えられる

データと UI の分離と関連付け

データグリッドがスマート

動画系の機能が強化されている

UI コントールの配置が簡単・速い

非ビジュアルコントロールもマウスで配置可能

基本的な機能がきちんと揃っている

マイナーな機能も結構揃ってる

勉強量が WPF より少なくて済む

日本語の情報が豊富

WPF では 1 つのことをやるために C# でコードを書くやり方と XAML でコードを書くやり方の 2 通りの実装方法があるが、片方しか掲載されていないこともしばしば。

WPF は英語含めても情報が見当たらない

まとめ

追記：MVVM について

蛇足：個人的な好み

使い方

const String EXTENDED_LENGTH_PATH_PREFIX = @"\\?\";
String aPath = EXTENDED_LENGTH_PATH_PREFIX + @"C:\Tmp\とても長いパス\123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789A123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890B\1234567890123456789Z\1234567890123456789Y\VeryVeryLongPath";
MessageBox.Show("Len: " + aPath.Length.ToString() + "\nExists: " + Directory.Exists(aPath).ToString());

互換性

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <startup>
    <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5"/>
  </startup>
  <runtime>
    <AppContextSwitchOverrides value="Switch.System.IO.UseLegacyPathHandling=false;Switch.System.IO.BlockLongPaths=false"/>
  </runtime>
</configuration>

private Boolean GetClrVersionRegistryNumber(out Int32 oClrVersion)
{
    using (RegistryKey aKey = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry32).OpenSubKey(@"SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\"))
    {
        if (aKey != null && aKey.GetValue("Release") != null)
        {
            oClrVersion = (Int32)aKey.GetValue("Release");
            return true;
        }
        else
        {
            oClrVersion = 0;
            return false;
        }
    }
}

private Boolean Is462()
{
    Int32 aClrVer;
    GetClrVersionRegistryNumber(out aClrVer);
    return aClrVer >= 394802;
}

private String ExtendPath(String oPath)
{
    // extended-length パスが使えない環境や、既に extended-length パスになっている場合はそのまま返る
    if (!Is462() || oPath.StartsWith(EXTENDED_LENGTH_PATH_PREFIX))
    {
        return oPath;
    }

    // extended-length パスにする
    // MAX_PATH 文字以上のフォルダー名をダイアログから取得した場合など、短いファイル名形式になっていることがあるため、
    // Path.GetFullPath() で長いファイル名形式に変換する
    return EXTENDED_LENGTH_PATH_PREFIX + Path.GetFullPath(oPath);
}

private void button1_Click(object sender, EventArgs e)
{
    try
    {
        String aPath = ExtendPath(@"C:\Tmp\短いパス");
        //String aPath = ExtendPath(@"C:\Tmp\とても長いパス\123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789A123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890B\1234567890123456789Z\1234567890123456789Y\VeryVeryLongPath");
        MessageBox.Show("4.6.2 or higher: " + Is462().ToString() + "\nLen: " + aPath.Length.ToString() + "\nExists: " + Directory.Exists(aPath).ToString());
    }
    catch (Exception oExcep)
    {
        MessageBox.Show(oExcep.Message);
    }
}

• どの SQLite ライブラリを使うか？
• ADO.NET とは？
• System.Data.SQLite のインストール
• System.Data.SQLite の基本
• テーブル構造定義クラスの導入
• レコードの挿入
• レコードの検索
• レコードの削除
• サンプルコード
• サンプルコードアプリの使い方
• 参考資料
• 更新履歴

どの SQLite ライブラリを使うか？

C# で SQLite を使うための方法はいくつかあり、自分が把握している範囲では以下のようになる。

• C 言語用 DLL を P/Invoke で使う……本家本元の DLL を使い、従来型の文字列によるクエリでプログラミング。最新のライブラリを使える（本稿執筆時点で 3.9.2）。しかし、C 言語レベルの生産性しかなく、労多くして功少なしなので、どうしても最新のバージョンを使いたい時以外はお薦めしない。
• System.Data.SQLite……SQLite 本家による .NET 用ライブラリ。データベースを便利に使う ADO.NET に対応しており、生産性が向上。C 言語用 DLL よりは多少バージョンが古い（3.8.11.1 ベース）ものの、総合的に一番お薦め。
• Mono.Data.SqliteClient…….NET のオープン・クロスプラットフォーム実装である Mono プロジェクトが作成したライブラリ。ADO.NET 対応。文字コードが Unicode（恐らく UTF-16）と記載があるのが気になる（本家は UTF-8）。別途本家 C 言語用 DLL が必要な模様。
• csharp-sqlite……マネージドコードのみで作成されたライブラリ。ADO.NET 対応。2011 年で開発停止の模様。バージョンは 3.7.7.1。マネージドコードしか使えない制約がある場合に重宝しそう。
• sqlite-net……コンパクトなライブラリ。ADO.NET 非対応。できる限り実行ファイルサイズを小さくしたい場合に活躍しそう。2012 年あたりで開発が停止しているようだ。

以降では、System.Data.SQLite を使う。

ADO.NET とは？

System.Data.SQLite は ADO.NET に対応しているが、そもそも ADO.NET とは何か。ADO.NET の詳しい解説は @IT の記事などに記載があるが、プログラマーから見たメリットを三行で書くとすれば、

• エディタのコード補完で楽ちんかつ安全にクエリを書ける（LINQ）
• 設計時からデータ構造をビジュアル化できる（Entity Framework）
• 使うデータベース（SQLite/Oracle……）によらず同じコードを使い回せる

あたりになるのではと理解している。

これにより、C 言語で SQLite をいじるよりもはるかに効率的にデータベースプログラミングが行える。

なお、本稿では、LINQ は使うが Entity Framework は使わない。

System.Data.SQLite のインストール

インストールは非常に簡単である。ここでは、Visual Studio 2015 Community / .NET Framework 4.5 の環境で実行しているものとする。

1. Visual Studio を起動し、SQLite を使いたいプロジェクトを開く
2. メニューの［ツール｜NuGet パッケージマネージャー｜ソリューションの NuGet パッケージの管理］をクリック
3. 検索窓に「SQLite」と入力して SQLite パッケージを検索
4. 検索結果の System.Data.SQLite を選択して、インストールボタンをクリック。関連するライブラリも含めて自動でインストールが終わる

たったこれだけ。

以前は、NuGet をコマンドラインで使う必要があった時代もあったようだが、現在は GUI で使える。

NuGet の欠点は、プロジェクトごとにインストールの必要があるため（プロジェクトに最適なバージョンを選んでインストールしてくれる）、SQLite を使うプロジェクトが複数ある場合は、ディスクをどんどん消費していく。その場合は、ダミープロジェクトでインストールしたバイナリを使い回したり、手動でバイナリをダウンロードして共用するといいかもしれない。

System.Data.SQLite の基本

データベースファイル（*.db とか *.sqlite3 とか）を開くには、SQLiteConnection クラスを使う。

SQLiteConnection を new する際にパラメーターを文字列で渡すのだが、SQLiteConnectionStringBuilder というお助けクラスを使うと、パラメーター文字列をミスなく生成できる。

SQLiteConnectionStringBuilder aConnectionString = new SQLiteConnectionStringBuilder
{
    DataSource = @"R:\Test.db"
};
using (SQLiteConnection aConnection = new SQLiteConnection(aConnectionString.ToString()))
{
    aConnection.Open();

    // ここにデータベース処理コードを書く
}

従来型の文字列によるコマンドを発行したい場合は、SQLiteCommand クラスを使う。

using (SQLiteCommand aCmd = new SQLiteCommand(aConnection))
{
    aCmd.CommandText = "CREATE TABLE IF NOT EXISTS t_test (test_id INTEGER NOT NULL PRIMARY KEY, test_name NVARCHAR NOT NULL, test_height REAL);";
    aCmd.ExecuteNonQuery();
}

テーブル構造定義クラスの導入

データへのアクセスを簡単・分かりやすくするために、テーブル構造を定義するクラスを作成する。

簡易名簿テーブル「t_test」が以下のような構造になっているとする。

フィールド名	型	NULL	備考
test_id	INTEGER	不可	連番
test_name	NVARCHAR	不可	氏名
test_height	REAL	可	身長

この場合、テーブル構造定義クラスは以下のようになる。

[Table(Name = "t_test")]
public class TTestData
{
    // ID
    [Column(Name = "test_id", DbType = "INT", CanBeNull = false, IsPrimaryKey = true)]
    public Int32 Id { get; set; }

    // 氏名
    [Column(Name = "test_name", DbType = "NVARCHAR", CanBeNull = false, UpdateCheck = UpdateCheck.Never)]
    public String Name { get; set; }

    // 身長
    [Column(Name = "test_height", DbType = "REAL", CanBeNull = true)]
    public Double? Height { get; set; }
}

フィールドをプロパティーとして定義しているシンプルなクラスである。

CREATE TABLE で作成した際のテーブル情報に合わせて、クラスメンバーの属性を記述している。例えば ID フィールドであれば、Name = "test_id" でデータベース上のフィールド名、DbType = "INT" でデータ型、CanBeNull = false で NULL 不可であることを表している。

DbType の型について注意点が 2 つ。

• 整数型は DbType = "INT" とする。INTEGER ではエラーになる。
• 文字列型は DbType = "NVARCHAR" とする。TEXT ではエラーになる。
  

特に、文字列型を TEXT としてしまうと、原因が分かりづらいエラーが発生し、ハマることになる。

身長フィールドは、NULL を許可している。CanBeNull = true にすると共に、プロパティーの型を「Double?」というように「?」を付けて nullable にしている。

レコードの挿入

テーブル構造定義クラスを導入したことにより、データベースの取扱が非常に簡単になる。

レコードの挿入を行うコードは、以下のようになる。SQLiteCommand クラスを使わなくて済むので全然 SQL っぽくなく、普通のコードのように書ける。

using (DataContext aConText = new DataContext(aConnection))
{
    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    aTableTest.InsertOnSubmit(new TTestData { Id = 1, Name = "Fukada Kyoko" });
    aTableTest.InsertOnSubmit(new TTestData { Id = 2, Name = "Eda Ha", Height = 180.0 });
    aTableTest.InsertOnSubmit(new TTestData { Id = 3, Name = "Dan Gerou", Height = 150.5 });
    aTableTest.InsertOnSubmit(new TTestData { Id = 4, Name = "Baba Takashi" });
    aTableTest.InsertOnSubmit(new TTestData { Id = 5, Name = "Aikawa Ai", Height = 145.6 });
    aConText.SubmitChanges();
}

ID 1 や 4 では身長を設定していないので、データベース上 NULL として格納される。

レコードの検索

レコードの検索は LINQ to SQLite と呼ばれる手法で行う。ちょっと変わった書き方だが、エディタのコード補完が効くのでミスが減る。

using (DataContext aConText = new DataContext(aConnection))
{

    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aQueryResult =
            from x in aTableTest
            where x.Name == "Eda Ha" || x.Height < 150.0
            orderby x.Height
            select x;
    foreach(TTestData aData in aQueryResult)
    {
        Debug.WriteLine(aData.Name);
    }
}

from のところが SQL の発行に相当する部分。なんとなく SQL に似ているので、読めば理解はできると思う。

where x.Name.Contains("hoge")

のようにすれば良い。

レコードの削除

レコードを削除する場合、削除したいレコードを検索し、それを削除する、という流れになる。

検索については前節と同じで、その結果を、DeleteAllOnSubmit() メソッドにぶち込むだけ、とこれまた簡単。

using (DataContext aConText = new DataContext(aConnection))
{
    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aDelTargets =
            from x in aTableTest
            where 140 < x.Height && x.Height < 160
            select x;
    aTableTest.DeleteAllOnSubmit(aDelTargets);
    aConText.SubmitChanges();
}

サンプルコード

以上をまとめたものを、サンプルコードとして公開する。

• 公開場所……GitHub
• ライセンス……クリエイティブ・コモンズ・ライセンス（表示 2.1 日本）（第三者部分を除く）
• ビルド方法……別途 LinqUtils.cs が必要。詳細はリポジトリ内の TestLinqToSqlite_ReadMe_JPN.html 参照

サンプルコードアプリの使い方

なお、サンプルコードアプリにはジェネリックの欄もあるが、こちらについては「LINQ to SQLite で共通カラム部分をジェネリックで運用する」を参照。

参考資料

• ADO.NET基礎講座
• C#とEntity FrameworkでSQLiteを使う（Entity Framework実践編）
• 【C#】System.Data.SQLiteを使ってみる
• MonoBook：csharp-sqlite、sqlite-net
• C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）【改訂版】
  

更新履歴

※改訂版を公開しましたので、改訂版をご覧ください。

SQLite3 を C# で使いたくて、いろいろ試していたら、文字列の比較でエラーが発生。

やったことは、System.Data.SQLite（SQLite の公式 ADO.NET プロバイダー）をインストールし、LINQ to SQLite でデーターベースにアクセス。ソースコードはおよそ以下のような感じ。

    Table<TTestData> aTableTest = aConText.GetTable<TTestData>();
    IQueryable<TTestData> aQueryResult =
            from x in aTableTest
            where x.Name == "Eda Ha"
            select x;

ここで、aContext は DataContext 型のインスタンス。TTestData は以下の定義。

[Table(Name = "t_test")]
public class TTestData
{
    // ID
    [Column(Name = "test_id", DbType = "INT", CanBeNull = false, IsPrimaryKey = true)]
    public Int32 Id { get; set; }

    // 氏名
    [Column(Name = "test_name", DbType = "TEXT", CanBeNull = false, UpdateCheck = UpdateCheck.Never)]
    public String Name { get; set; }
}

このようなコードを実行すると、IQueryable の結果を使う段階で、NotSupportedException が発生する。

    例外がスローされました: 'System.NotSupportedException' (System.Data.Linq.dll の中)
    追加情報:SQL Server では、NText、Text、Xml、または Image の各データ型の比較はハンドルされません。

where x.Name == "Eda Ha" の箇所が where x.ID == 1 のような数値型の比較だと例外は発生しない。

原因がわからずさんざん悩んだ。「SQL Server では～」のエラーメッセージで検索しても情報が見つからない。

結論としては、Name の DbType がまずかった。

DbType を NVARCHAR にして、CREATE TABLE する際の型も NVARCHAR にしたら、うまく動作するようになった。

どうやら、SQLite を .NET で使う場合は、文字列型は NVARCHAR にしないといけないようだ。

なお、エラーが発生した環境は、

• Visual Studio Community 2015
• .NET 4.5
• System.Data.SQLite 1.0.98.0（sqlite-netFx45-setup-x86-2012-1.0.98.0.exe）
  

関連記事

• C# で SQLite を便利に使うサンプルコード（LINQ to SQLite）

.NET Framework 4.5 C# / Visual Studio 2013 にて、Microsoft Speech API (SAPI) 5.4 の TTS エンジンのサンプルコード（テストコード）「TestUtaYomiEngine」を作成した。

不完全ではあるものの、SAPI 音声合成エンジン側の C# コードはあまり見かけないので、参考になるかもしれないと思い公開する。SAPI に限らず、C# の COM コンポーネントは少ないので、そちらの方面でも参考になるかもしれない。

逆に、アドバイス等あれば、是非とも教えて頂きたい。

本サンプルコードの挙動

本サンプルコードは、既に公開している音声合成エンジン「唄詠（うたよみ）」（Ver 6 系）の代替エンジンとして動作する。
入力された文字にかかわらず、「C:\Test.wav」（44.1kHz、16 ビット、モノラル限定）を再生する。

本サンプルコードで動く部分

以下のテキストスピーチソフトとの組み合わせで動作する。これらのアプリは恐らく、SpXXXX 系の純粋な SAPI を使用しているものと思われる。

• SofTalk
• TextToWav
• 棒読みちゃん（フォーマット変更エラーが表示されるが再生は可能）
  

本サンプルコードで動かない部分

.NET Framework の SpeechSynthesizer クラスを使用しているテキストスピーチソフト（ゆっくり MovieMaker など）との組み合わせでは動作しない。

使い方

• Ver 6 系の唄詠をインストールし、テキストスピーチソフトと組み合わせて正しく動作することを確認する。
• サンプルコードを管理者権限でビルドする。Ver 6 系の唄詠エンジンの代わりに、ビルドしたコードが登録される。
• 44.1kHz、16 ビット、モノラルの WAVE ファイル（UTAU 音源の原音 WAVE を使うと良い）を C:\Test.wav に保存する。
• テキストスピーチソフトで唄詠音源でしゃべらせると、サンプルコードが動作し、上記 WAVE が再生される。
• 唄詠以外のソフトのベースとして使う際は、必ず Guid を変更すること。

ダウンロード

• Dropbox

ライセンス

• クリエイティブ・コモンズ・ライセンス（表示 2.1 日本）

関連記事

• 次期唄詠デバッグメモ（COM サーバー編）

更新情報

• 2015/11/21 ダウンロードリンクが切れていたので、サルベージして再公開

C# でプラグインとやり取りしたいと思ってテストコードを作っていたのだが、思わぬ所で躓いた。

やりたいことはごく普通で、

• プラグインのインターフェースを定義
• インターフェースを実装したプラグイン DLL を作成
• ホスト（EXE）側から、プラグイン DLL を動的に呼びだし

というもの。

プラグインのインターフェースは以下のようなシンプルなもの（PluginInterface.cs）。

namespace TestPlugin
{
    public interface ITestPlugin
    {
        Int32 Diff(Int32 oNum1, Int32 oNum2);
    }
}

このインターフェースを実装した TestDLL.dll を作成しておき、ホスト（EXE）側で以下のコードで呼びだした。

private void button12_Click(object sender, EventArgs e)
{
    ITestPlugin aPI = null;
    try
    {
        Assembly aAsm = Assembly.LoadFrom(@"C:\TestDLL.dll");
        foreach (Type aType in aAsm.GetTypes())
        {
            if (aType.IsInterface)
            {
                continue;
            }

            Object aObj = Activator.CreateInstance(aType);
            aPI = aObj as ITestPlugin;
            if (aPI != null)
            {
                MessageBox.Show("プラグインの計算結果：" + aPI.Diff(5, 3).ToString());
                break;
            }
        }
    }
    catch (Exception oExcep)
    {
        MessageBox.Show(oExcep.Message);
    }
    if (aPI == null)
    {
        MessageBox.Show("プラグインをロードできませんでした。");
    }
}

実行してみると、Activator.CreateInstance() でオブジェクトが生成され、aObj に値が入っているのが（デバッガで）確認できた。また、別途コードを追加して aType.GetInterfaces() でインターフェース名を取得すると、ITestPlugin を有していることも確認できた。

しかし！

次の行のキャストは失敗し、aPI は null のままであった。

いろいろ悩んだが、結果的には、「プラグインインターフェースを定義している PluginInterface.cs を、DLL とホストの双方で直接プロジェクトに追加していた」のが原因だった。

解決策としては、

1. PluginInterface.cs を直接追加したプロジェクトで予め Interface.dll を作っておき、プラグイン DLL とホストの双方から、参照設定で Interface.dll を参照する。
2. ホスト側のプロジェクトに PluginInterface.cs を直接追加してビルドし、プラグイン DLL ではホストのバイナリを参照設定で参照する。
   

のいずれかを行えば良い。解決策 1 だとバイナリファイルが 3 つになるので、ファイルの数で言えば、解決策 2 の方がすっきりする。

しかし、双方で直接プロジェクトに追加するとなぜうまく動かないのかは不明。GUID の問題なのかと思って ITestPlugin に Guid 属性を付けてみたりもしたが、改善しなかった。