C# 入門

C# で iOS の Push Notification（プッシュ通知）を送信する方法

Fri, 16 Jun 2023 21:35:00 GMT

C# で iOS の Push Notification（プッシュ通知）を送信する方法

C# で iOS の Push Notification（プッシュ通知）を送信する
ここでは、C# を使って、iOS デバイスに Push Notification（プッシュ通知）を送信する方法をご説明します。

目次
iOS の Push Notification（プッシュ通知）を送る準備をする
C# を使って Push Notification（プッシュ通知）を送信する

iOS の Push Notification（プッシュ通知）を送る準備をする
iOS の Push Notification（プッシュ通知）は次の順番で送られます。

Provider server から Apple Push Notification service (APNs) にプッシュ通知のリクエストを post する
Apple Push Notification service (APNs) がユーザーの iOS デバイスにプッシュ通知を送る
iOS デバイスでプッシュ通知を受信し、表示される
この記事では 1 番の APNs に post する部分のプログラムをご説明します。

Apple Push Notification service (APNs) に Push Notification（プッシュ通知）を送信するには、HTTP/2 と TLS 1.2 以降で接続して Post リクエストを送ります。

Post するのに何を使って実装しても良いですが、ここでは C# を使ってプッシュ通知を送信します。

Push Notification（プッシュ通知）を送信する際には以下のものが必要になります。

iOS デバイスのデバイストークン
プッシュ通知を受信する iOS アプリの Bundle Identifier
Apple Push Notification service 証明書からエクスポートされた p12 ファイルとパスワード
まだ、Apple Push Notification service 証明書の生成・インストールや、プッシュ通知を受信する iOS アプリを生成、デバイストークンの取得をしていない方は「Push Notification（プッシュ通知）を実装する方法」をご参考に、済ませておいてください。

C# を使って Push Notification（プッシュ通知）を送信する
Visual Studio で Consol App を新規作成します。

HTTP/2 で Post しなければならないので、HttpRequestMessage で Verson 2.0 をサポートしている Framework を選択してください。

.NET Framework はサポートしていません。 .NET Core は古いバージョンでなければサポートされています。

C# を使って、iOS デバイスに Push Notification（プッシュ通知）を送信するには、次のようにできます。

using System.Security.Authentication;
using System.Security.Cryptography.X509Certificates;

class Program
{
static void Main(string[] args)
{
try
{
var apnsURL = "api.sandbox.push.apple.com:443"; // Development server
var deviceToken = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
var certPath = "C:\Test\PushTest\PushTestCertificate.p12";
var certPassword = "Password";
var bundleIdentifier = "com.softmoco.PushTest";
var payload = "{\"aps\":{\"alert\":\"Push Notification Test from C#!!!\",\"sound\":\"default\",\"badge\":1}}";

var url = string.Format("https://{0}/3/device/{1}", apnsURL, deviceToken);

var certData = File.ReadAllBytes(certPath);
var cert = new X509Certificate2(certData, certPassword, X509KeyStorageFlags.MachineKeySet | X509KeyStorageFlags.PersistKeySet | X509KeyStorageFlags.Exportable);

using (var httpHandler = new HttpClientHandler { SslProtocols = SslProtocols.Tls12 })
{
httpHandler.ClientCertificates.Add(cert);

using (var clent = new HttpClient(httpHandler, true))
{
using (var request = new HttpRequestMessage(HttpMethod.Post, url))
{
request.Version = new Version(2, 0);
request.Headers.Add("apns-topic", bundleIdentifier);
request.Content = new StringContent(payload);

try
{
using (var result = clent.SendAsync(request).GetAwaiter().GetResult())
{
var content = result.Content.ReadAsStringAsync().Result;
Console.WriteLine(string.Format("StatusCode: {0}, Content: {1}", result.StatusCode, content));
}
}
catch (Exception e)
{
Console.WriteLine(string.Format("Exception 1: {0}", e.ToString()));
}
}
}
}
}
catch (Exception e)
{
Console.WriteLine(string.Format("Exception 2: {0}", e.ToString()));
}
}
}
C# で iOS の Push Notification（プッシュ通知）を送信する方法 1

apnsURL には、Apple Push Notification service (APNs) サーバーの URL を指定します。

post する URL は以下の [APNs サーバの URL]/3/device/[device token] になります。

現在の APNs のサーバの URL は以下の通りです。

Development server: api.sandbox.push.apple.com:443
Production server: api.push.apple.com:443

deviceToken には「Push Notification（プッシュ通知）を受信する iOS アプリを作る」で取得したデバイストークンを指定します。

certPath には p12 ファイルのファイルパスを、certPassword には p12 ファイルをエクスポートした時に指定したパスワードを指定します。

p12 ファイルは「証明書から p12 ファイルをエクスポートし pem ファイルに変換する」でエクスポートしたものを使います。

この記事の方法で post する場合は、pem ファイルに変換する必要はありません。

C# で iOS の Push Notification（プッシュ通知）を送信する方法 2

bundleIdentifier には、「Xcode で Bundle Identifier を設定する」で設定した Bundle Identifier (com.softmoco.PushTest) を指定します。

プッシュ通知の payload は今回は次のものを送信します。

{
"aps": {
"alert": "Push Notification Test from C#!!!",
"sound": "default",
"badge": 1
}
}

コードをざっとご説明します。

19 ~ 20 行目では、p12 ファイルから X509Certificate2 オブジェクトを生成しています。

22 行目では httpClientHandler オブジェクトを SslProtocols.Tls12 を指定して生成しています。

24 行目では、先ほどの X509Certificate2 オブジェクトを httpHandler の ClientCertificates に追加しています

26 行目では、先ほどの httpClientHandler オブジェクトを指定して HttpClient オブジェクトを生成しています。

28 行目では Post メソッドと URLを指定して、HttpRequestMessage オブジェクトを request という名前で生成しています。

30 行目では HTTP/2 を使うように request の Version を 2.0 に指定しています。

31 行目では request の Headers にキー: apns-topic、値: bundleIdentifier を追加します。

32 行目では request の Content に payload から StringContent オブジェクトを生成して代入しています。

36 行目では post リクエストを送信して、結果を取得しています。

38 行目ではレスポンスの Content を文字列として取得しています。

39 行目ではレスポンスの StatusCode と Content を出力しています。

これを実行すると、次のように PushTest (com.softmoco.PushTest) の iOS アプリをインストールした iPhone で Push Notification（プッシュ通知）を受信できました。

C# で iOS の Push Notification（プッシュ通知）を送信する方法 3

C# で iOS の Push Notification（プッシュ通知）を送信する方法 4

以上、C# で iOS の Push Notification（プッシュ通知）を送信する方法をご説明しました。

C# で Gmail の SMTP サーバを使ってメールを送信する方法

Tue, 07 Feb 2023 02:25:00 GMT

C# で Gmail の SMTP サーバを使ってメールを送信する方法

C# で Gmail の SMTP サーバを使ってメールを送信する
ここでは、>C# で Gmail の SMTP サーバを使ってメールを送信する方法をご説明します。

目次
Google でアプリパスワード (App Password) を生成する
MailKit をインストールする
C# で Gmail の SMTP サーバを使ってメールを送信する
Google でアプリパスワード (App Password) を生成する
Gmail の SMTP サーバを使ってメールを送信する際に必要な、アプリパスワード (App Password) を生成します。

アプリパスワードを生成するには、2 段階認証プロセスが有効でなければならないので、していない方は先に有効にしておいてください。

Google アカウントの [セキュリティ (Security)] を選択し、[Google へのログイン (Signing in to Google)] の箇所の [アプリパスワード (App Passwords)] を選択します。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 1

アプリパスワード (App Passwords) の画面で、アプリとデバイスを選択します。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 2

今回はアプリには Mail、デバイスには Windows Computer を選択し、[生成 (GENERATE)] ボタンをクリックします。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 3

C# で Gmail の SMTP サーバを使ってメールを送信する方法 4

C# で Gmail の SMTP サーバを使ってメールを送信する方法 5

アプリパスワードが生成され表示されるので、これを使います。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 6

MailKit をインストールする
Visual Studio でコンソールアプリの新規プロジェクトを生成します。

SmtpClient Class のドキュメントページで紹介されている MailKit を使うので、インストールします。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 10

ツール > NuGet パッケージマネージャー > パッケージマネージャーコンソールを選択します。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 7

コンソールで Install-Package MailKit と入力して実行すると、MailKit がインストールされます。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 8

C# で Gmail の SMTP サーバを使ってメールを送信する
C# で Gmail の SMTP サーバを使ってメールを送信するには、次のようにできます。

using MailKit.Net.Smtp;
using MimeKit;
using MailKit.Security;

namespace MailTest
{
class Program
{
static void Main(string[] args)
{
var smtpServer = "smtp.gmail.com";
var port = 587;
var user = "xxxxxxxxx@gmail.com";
var password = "xxxxxxxxxxxxxxxxx";

var fromAddress = "xxxxxxxxx@gmail.com";
var toAddress = "toaddress@gmail.com";
var subject = "Gmail SMTP Test";
var body = "これは Gmail SMTP のテストメールです。";
var isHtmlBody = false;

var message = new MimeMessage();
message.From.Add(new MailboxAddress(fromAddress, fromAddress));
message.To.Add(new MailboxAddress(toAddress, toAddress));
message.Subject = subject;

var builder = new BodyBuilder();
if (isHtmlBody)
{
builder.HtmlBody = body;
}
else
{
builder.TextBody = body;
}
message.Body = builder.ToMessageBody();

using (var client = new SmtpClient())
{
client.Connect(smtpServer, port, SecureSocketOptions.StartTls);
client.Authenticate(user, password);
client.Send(message);
client.Disconnect(true);
}
}
}
}
C# で Gmail の SMTP サーバを使ってメールを送信する方法 9

Gmail の SMTP サーバは smtp.gmail.com、ポートは 587 です。

user にはアプリパスワードを生成したアカウントの gmail のアドレスを、password には生成したアプリパスワードを指定します。

22 ~ 25 行目では、MimeMessageオブジェクトを生成して、メールの From、To、Subject を指定しています。

27 ~ 36 行目では、メールの Body を生成しています。テキストでも HTML でもいいように BodyBuilder を使っています。

38 ~ 44 行目が、SmtpClientクライアントを使ってメールを送信している箇所です。

Connect メソッドに上で定義した smtpServer と port を渡し、SecureSocketOptions には SecureSocketOptions.StartTls を指定しています。

Authenticateメソッドに上で定義した user と password を渡して認証しています。

Send メソッドでメールを送信して、Disconnect で切断しています。

これを実行すると、以下のようなメールが送信されました。

C# で Gmail の SMTP サーバを使ってメールを送信する方法 11

以上、C# で Gmail の SMTP サーバを使ってメールを送信する方法をご説明しました。

C# で複数のプロパティの値でリストをソートする方法

Tue, 24 Jan 2023 23:15:00 GMT

C# で複数のプロパティの値でリストをソートする方法

C# で複数のプロパティの値でリストをソートする
クラスのオブジェクトのリスト (List) があって、オブジェクトの複数のプロパティの値でソートしたリストを取得したい時ありませんか？

例えば、次のような Student クラスのリスト　List があって、ClassCode、LastName、FirstName でソートしたリストを取得したいような時です。

class Student
{
public int StudentID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public string Gender { get; set; }
public string ClassCode { get; set; }

public Student(int studentID, string firstName, string lastName, string gender, string classCode)
{
StudentID = studentID;
FirstName = firstName;
LastName = lastName;
Gender = gender;
ClassCode = classCode;
}
}

C# でリストを複数のプロパティの値で昇順にソートしたリストを取得したいい時には、Linq の OrderBy メソッドと ThenBy メソッドが使えます。

ひとつめのプロパティには OrderBy を使い、それ以降のプロパティには ThenBy を使います。

例えば、プロパティ1、プロパティ2、プロパティ3 の順番で昇順にソートしたい時は次のようにします。

リスト.OrderBy(obj => obj.プロパティ1).ThenBy(obj => obj.プロパティ2).ThenBy(obj => obj.プロパティ3).ToList()
obj としている箇所は他の名前でも大丈夫です。

Linq の OrderBy や ThenBy は IOrderedEnumerable を返すので、ToList メソッドで List に変換しています。

降順にソートしたい時は代わりに Linq の OrderByDescending メソッドや ThenByDescending メソッドを使います。

使い方は OrderBy や ThenBy と同じです。

C# で students リストを ClassCode、LastName、FirstName でソートしたリストを取得サンプルーコードは次の通りです。

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

namespace ListTest
{
class Program
{
static void Main(string[] args)
{
var students = new List();
students.Add(new Student(1, "Kana", "Yamada", "F", "ClassC"));
students.Add(new Student(2, "Keita", "Maeda", "M", "ClassC"));
students.Add(new Student(3, "Kaede", "Tanaka", "F", "ClassA"));
students.Add(new Student(4, "Ryota", "Suzuki", "M", "ClassB"));
students.Add(new Student(5, "Yuri", "Nakata", "F", "ClassB"));
students.Add(new Student(5, "Misaki", "Nakata", "F", "ClassB"));
students.Add(new Student(5, "Mana", "Yamamoto", "F", "ClassA"));

foreach(var s in students)
{
Console.WriteLine(s.ClassCode + ": " + s.LastName + ", " + s.FirstName);
}

Console.WriteLine("-------------------");

var students2 = students.OrderBy(s => s.ClassCode).ThenBy(s => s.LastName).ThenBy(s => s.FirstName).ToList();

foreach (var s in students2)
{
Console.WriteLine(s.ClassCode + ": " + s.LastName + ", " + s.FirstName);
}

Console.WriteLine("-------------------");

var students3 = students.OrderByDescending(s => s.ClassCode).ThenBy(s => s.LastName).ThenByDescending(s => s.FirstName).ToList();

foreach (var s in students3)
{
Console.WriteLine(s.ClassCode + ": " + s.LastName + ", " + s.FirstName);
}
}
}

class Student
{
public int StudentID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }
public string Gender { get; set; }
public string ClassCode { get; set; }

public Student(int studentID, string firstName, string lastName, string gender, string classCode)
{
StudentID = studentID;
FirstName = firstName;
LastName = lastName;
Gender = gender;
ClassCode = classCode;
}
}
}

11 ~ 18 行目では Student クラスのオブジェクトを持つ List を生成しています。

27 行目では、Linq の OrderBy と ThenBy メソッドを使って、students リストを ClassCode、LastName、FirstName の昇順にソートしたオブジェクトを持つ List を生成しています。

36 行目では、Linq の OrderByDescending と ThenByDescending メソッドも使って、students リストを ClassCode 降順、LastName 昇順、FirstName 降順にソートしたオブジェクトを持つ List を生成しています。

上のコードを実行すると次のようになります。

ClassC: Yamada, Kana
ClassC: Maeda, Keita
ClassA: Tanaka, Kaede
ClassB: Suzuki, Ryota
ClassB: Nakata, Yuri
ClassB: Nakata, Misaki
ClassA: Yamamoto, Mana
-------------------
ClassA: Tanaka, Kaede
ClassA: Yamamoto, Mana
ClassB: Nakata, Misaki
ClassB: Nakata, Yuri
ClassB: Suzuki, Ryota
ClassC: Maeda, Keita
ClassC: Yamada, Kana
-------------------
ClassC: Maeda, Keita
ClassC: Yamada, Kana
ClassB: Nakata, Yuri
ClassB: Nakata, Misaki
ClassB: Suzuki, Ryota
ClassA: Tanaka, Kaede
ClassA: Yamamoto, Mana
Press any key to continue . . .
C# で複数のプロパティの値でリストをソートする方法 1

新しくできた List の中の Student オブジェクトは、元のリストと同じ Student オブジェクトをポイントしているので、クラス変数の値を変更すると、全てのリストに入っている同じ Student オブジェクトの値が変更されます。

以上、C# で複数のプロパティの値でリストをソートする方法をご紹介しました。

C# のリストから指定したプロパティの値を持つオブジェクトを取得する方法

Mon, 01 Nov 2021 22:32:00 GMT

C# のリストから指定したプロパティの値を持つオブジェクトを取得する方法

C# のクラスオブジェクトのリスト (List) があって、ID などの値を指定して、その ID を持つオブジェクトを取得したいような時ありますよね。

例えば、次のような Student クラスのリスト List があって、そのうち、StudentID = 2 の Student オブジェクトを取得したいような時です。

class Student
{
public int StudentID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }

public Student(int studentID, string firstName, string lastName)
{
StudentID = studentID;
FirstName = firstName;
LastName = lastName;
}
}
リスト内に条件に合致するオブジェクトが複数存在して、結果をリストとして取得したいような時はこちらをごらんください。

今回は、リスト内に条件に合致するオブジェクトかひとつだけ存在すると想定されるようなケースで、それを Student オブジェクトとして取得する方法をご紹介します。

C# のリストから指定したプロパティの値を持つオブジェクトを取得する方法
C# でリストを ID などの値を指定してフィルターして、その ID を持つオブジェクトを取得したい時には、Linq の FirstOrDefault メソッドや、List の Find メソッドが使えます。

使い方はリスト.FirstOrDefault(obj => [obj を使った条件式]) やリスト.Find(obj => [obj を使った条件式]) のように使います。

どちらも obj としている箇所は他の名前でも大丈夫で、データ型はリストに入っているオブジェクトのデータ型になります。

戻り値はどちらのメソッドとも、オブジェクトが見つかった時はそのオブジェクトが、見つからなかったときは、そのオブジェクトのデフォルト値がかえります。

クラスのデフォルト値は null なので、クラスオブジェクトのリストの時は見つからなかった時に null がかえります。

また、複数のオブジェクトが条件に合致した時は、両方のメソッドと共に、最初にみつけたオブジェクトを返します。

C# のクラスオブジェクトのリストに対して、指定した ID を持つオブジェクトを取得するサンプルーコードは次の通りです。

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

namespace ConsoleApp1
{
class Program
{
static void Main(string[] args)
{
var students = new List();
students.Add(new Student(1, "Kana", "Yamada"));
students.Add(new Student(2, "Keita", "Maeda"));
students.Add(new Student(3, "Kaede", "Tanaka"));
students.Add(new Student(4, "Ryota", "Suzuki"));
students.Add(new Student(5, "Saki", "Taguchi"));

var s1 = students.FirstOrDefault(s => s.StudentID == 2);
if (s1 != null)
{
Console.WriteLine(s1.FirstName);
}

Console.WriteLine("-------------------");

var s2 = students.Find(s => s.StudentID == 2);
if (s2 != null)
{
Console.WriteLine(s2.FirstName);
}
}
}

class Student
{
public int StudentID { get; set; }
public string FirstName { get; set; }
public string LastName { get; set; }

public Student(int studentID, string firstName, string lastName)
{
StudentID = studentID;
FirstName = firstName;
LastName = lastName;
}
}
}

11 ~ 16 行目は Student クラスのオブジェクトを持つ List を生成しているだけです。

18 行目では、Linq の FirstOrDefault メソッドを使って、students リストの中から、StudentID が 2 の Student オブジェクトを取得しています。

26 行目では、List の Find メソッドを使って、students リストの中から、StudentID が 2 の Student オブジェクトを取得しています。

上のコードを実行すると次のようになります。

Keita
-------------------
Keita
C# のリストから指定したプロパティの値を持つオブジェクトを取得する方法 1

取得した Student オブジェクトは、リスト内にあったのと同じ Student オブジェクトをポイントしているので、取得したオブジェクトのクラス変数を変更すると、リスト内の Student オブジェクトも変更されます。

以上、C# のリストから指定したプロパティの値を持つオブジェクトを取得する方法をご説明しました。

C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成する方法

Wed, 20 Jan 2021 19:48:00 GMT

C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成する方法

C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成する
クラスのオブジェクトが複数入っているリスト (List) があって、条件を指定して、それに合った要素のみを持つ新しいリストを生成したい時ありませんか？

例えば、次のような Student クラスのリスト　List があって、そのうち、Birthday が null の Student オブジェクトのみを含むリストを取得したいような時です。

class Student
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Birthday { get; set; }
public bool TestPassed { get; set; }

public Student(string firstName, string lastName, DateTime? birthday, bool testPassed)
{
FirstName = firstName;
LastName = lastName;
Birthday = birthday;
TestPassed = testPassed;
}
}

C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成したい時には、List の FindAll メソッドや、Linq の Where メソッドが使えます。

使い方はリスト.FindAll(obj => [obj を使った条件式]) やリスト.Where(obj => [obj を使った条件式]).ToList()のような感じで指定できます。

どちらも obj としている箇所は他の名前でも大丈夫で、データ型はリストに入っているオブジェクトのデータ型になります。

Linq の Where のほうは IEnumerable を返すので、ToList メソッドで List に変換しています。

C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成するサンプルーコードは次の通りです。

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

namespace ConsoleApp1
{
class Program
{
static void Main(string[] args)
{
var students = new List();
students.Add(new Student("Kana", "Yamada", null, true));
students.Add(new Student("Keita", "Maeda", Convert.ToDateTime("2010/05/15"), true));
students.Add(new Student("Kaede", "Tanaka", Convert.ToDateTime("2009/02/01"), false));
students.Add(new Student("Ryota", "Suzuki", Convert.ToDateTime("2010/11/24"), true));
students.Add(new Student("Saki", "Taguchi", null, false));

var students1 = students.FindAll(s => s.Birthday == null);
foreach (var s in students1)
{
Console.WriteLine(s.FirstName);
}

Console.WriteLine("-------------------");

var students2 = students.Where(s => s.Birthday == null).ToList();
foreach (var s in students2)
{
Console.WriteLine(s.FirstName);
}

Console.WriteLine("-------------------");

var students3 = students.Where(s => s.Birthday == null && s.TestPassed ).ToList();
foreach(var s in students3)
{
Console.WriteLine(s.FirstName);
}
}
}

class Student
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Birthday { get; set; }
public bool TestPassed { get; set; }

public Student(string firstName, string lastName, DateTime? birthday, bool testPassed)
{
FirstName = firstName;
LastName = lastName;
Birthday = birthday;
TestPassed = testPassed;
}
}
}

11 ~ 16 行目は Student クラスのオブジェクトを持つ List を生成しているだけです。

18 行目では、List の FindAll メソッドを使って、students リストの中から、Birthday が null の Student オブジェクトのみを持つ、List を生成しています。

26 行目では、Linq の Where メソッドを使って、students リストの中から、Birthday が null の Student オブジェクトのみを持つ、List を生成しています。

複数の条件を指定したい時は if 文などと同様に && や || などで複数の条件を指定することができます。 34 行目では、Birthday が null で　TestPassed が true の Student オブジェクトのみを持つ、List を生成しています。

上のコードを実行すると次のようになります。

Kana
Saki
-------------------
Kana
Saki
-------------------
Kana
C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成する方法 1

新しくできた List の中の Student オブジェクトは、元のリストと同じ Student オブジェクトをポイントしているので、クラス変数の値を変更すると、全てのリストに入っている同じ Student オブジェクトの値が変更されます。

また、フィルターの結果、条件に合致する Student オブジェクトが存在しなくても、空のリストができるだけでエラーにはなりません。

以上、C# でリストをフィルターして、条件に合致した要素のみを持つリストを生成する方法をご紹介しました。

C# で条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントする方法

Wed, 20 Jan 2021 01:24:00 GMT

C# で条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントする方法

条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントする
クラスのオブジェクトが複数入っているリスト (List) があって、クラスの変数が特定の値を持つオブジェクト数を数えたいような時ありませんか？

例えば、次のような Student クラスのリスト List があって、Birthday が null の要素数や、TestPassed が true の要素数を数えたいような時です。

class Student
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Birthday { get; set; }
public bool TestPassed { get; set; }

public Student(string firstName, string lastName, DateTime? birthday, bool testPassed)
{
FirstName = firstName;
LastName = lastName;
Birthday = birthday;
TestPassed = testPassed;
}
}

C# で条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントしたい時には、System.Linq の Count メソッドが使えます。

使い方はリスト.Count(obj => [obj を使った条件式]) のような感じで指定できます。

obj としている箇所は他の名前でも大丈夫で、obj のデータ型はリストに入っているオブジェクトのデータ型になります。

Linq の Count メソッドを使って、条件を指定して要素数を数えるサンプルーコードは次の通りです。

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

namespace ConsoleApp1
{
class Program
{
static void Main(string[] args)
{
var students = new List();
students.Add(new Student("Kana", "Yamada", null, true));
students.Add(new Student("Keita", "Maeda", Convert.ToDateTime("2010/05/15"), true));
students.Add(new Student("Kaede", "Tanaka", Convert.ToDateTime("2009/02/01"), true));
students.Add(new Student("Ryota", "Suzuki", Convert.ToDateTime("2010/11/24"), true));
students.Add(new Student("Saki", "Taguchi", null, false));

Console.WriteLine(students.Count(s => s.Birthday == null));
Console.WriteLine(students.Count(s => s.TestPassed == true));
Console.WriteLine(students.Count(s => s.FirstName.StartsWith("K")));
Console.WriteLine(students.Count(s => s.LastName == "ABC"));
}
}

class Student
{
public string FirstName { get; set; }
public string LastName { get; set; }
public DateTime? Birthday { get; set; }
public bool TestPassed { get; set; }

public Student(string firstName, string lastName, DateTime? birthday, bool testPassed)
{
FirstName = firstName;
LastName = lastName;
Birthday = birthday;
TestPassed = testPassed;
}
}
}

11 ~ 16 行目は Student クラスのオブジェクトを持つ List を生成しています。

18 行目は、students リストの中で、Birthday が null の要素数をカウントしています。

19 行目は、students リストの中で、TestPassed が true の要素数をカウントしています。

20 行目は、students リストの中で、FirstName が K で始まる要素数をカウントしています。

21 行目は、students リストの中で、LastName が ABC の要素数をカウントしています。条件を満たす要素がない場合も 0 が返るだけでエラーにはなりません。

実行すると次のようになります。

2
4
3
0
C# で条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントする方法 1

以上、C# で条件を指定して、リストや配列内のオブジェクトの数（要素数）をカウントする方法をご紹介しました。

C# で OleDbDataReader を使って MS Access から値を取得する

Tue, 07 Jan 2020 21:33:00 GMT

C# で OleDbDataReader を使って MS Access から値を取得する

MS Access のテーブルから値を取得する
今回は C# で MS Access ファイル (.accdb) のテーブルから、OleDbDataReader を使って値を取得してみましょう。

次のような二つの Test1.accdb と Test2.accdb という名前の MS Access ファイルがあります。

どちらも Students という名前のテーブルに以下のようなデータがはいっています。

Test1.accdb
C# で MS Access から値を取得する 1

Test2.accdb
C# で MS Access から値を取得する 2

Test2.accdb のほうはパスワードで制限がかけられています。

C# で MS Access から値を取得する 3

これらの MS Access ファイルの Students テーブルから値を取得してみましょう。

MS Access への接続文字列
まず、MS Access への接続文字列は次のようになります。

Data Source=[MS Access ファイルへのパス]
Jet OLEDB:Database Password=[データベースのパスワード]

パスワードでデータベースへのアクセスが制限されていない場合

connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Data Source=D:\\Test\\C#\\MSAccess\\Test1.accdb"
パスワードでデータベースへのアクセスが制限されている場合

connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Data Source=D:\\Test\\C#\\MSAccess\\Test2.accdb;Jet OLEDB:Database Password=MyPassword"
これを「データベースの接続文字列を App.config から取得する」の方法で App.config に置いて、接続文字列を使う準備をしておきます。

connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Data Source=D:\\Test\\C#\\MSAccess\\Test1.accdb" />
connectionString="Provider=Microsoft.ACE.OLEDB.12.0;Data Source=D:\\Test\\C#\\MSAccess\\Test2.accdb;Jet OLEDB:Database Password=MyPassword" />

C# で MS Access から値を取得する 4

OleDbDataReader を使って MS Access から値を取得する
OleDbDataReader を使ってデータベースから取得したデータを読んで、コンソールに書き出してみましょう。

MS Access データベースの Students テーブルから、StudentID, FirstName, LastName を取得するコードは以下の通りです。

string connString = ConfigurationManager.ConnectionStrings["DB2"].ConnectionString;
string queryString = "SELECT StudentID, FirstName, LastName FROM Students;";

using (OleDbConnection conn = new OleDbConnection(connString))
{
var comm = new OleDbCommand(queryString, conn);
conn.Open();

using (OleDbDataReader dr = comm.ExecuteReader())
{
while (dr.Read())
{
Console.WriteLine(string.Format("{0}: {1} {2}",
dr["StudentID"],
dr["FirstName"],
dr["LastName"]));
}
}
}
C# で MS Access から値を取得する 5

OleDbDataReader を使うには System.Data.OleDb、config ファイルから値を取得するのに System.Configuration が必要ですので、using ディレクティブで追加しておきます。

このコードで行っている処理の流れは次の通りです。

接続文字列をコンストラクターに渡して OleDbConnection を生成する。
アドホック・クエリとコネクションをコンストラクターに渡して OleDbCommand を生成する。
コネクションを open する。
OleDbCommand の ExecuteReader メソッドを呼んで、OleDbDataReader を生成する。
OleDbDataReader の Read メソッドを While ループで実行することで、1 行ずつ読み込む。
読んだ行をコンソールにフォーマットして書き出す。

OleDbConnection や OleDbDataReader は using ステートメントを使っておかないと、Exception でコードパスが飛んだ時に、Close し忘れる可能性がでてきてしまいますので、using を使います。

OleDbDataReader の Read メソッドはまだ行がある時は true、もうない時は　false を返してくれるので、While(dr.Read()) としておけば全行読み終わった時点で while ループを抜けてくれます。

SqlDataReader の時とほとんど一緒ですね！

こちらが上のコードの ConnectionStrings を DB1、DB2、と変更して実行した結果です。

Test1.accdb
C# で MS Access から値を取得する 6

Test2.accdb
C# で MS Access から値を取得する 7

C# で数値をフォーマットされた文字列に変換する

Sat, 28 Dec 2019 19:14:00 GMT

C# で数値をフォーマットされた文字列に変換する

数値をフォーマットされた文字列に変換する
int、double、decimal などの数値型の値を、小数点以下なし、小数第二位まで等、フォーマットされた文字列に変換したい時ありますよね。

ここでは、数値を文字列に変換する際に良く使うフォーマットの例を書いておこうと思います。

今回はサンプルとして Decimal 型の値を文字列に変換する例を載せておきます。

目次
1. スタンダードフォーマット文字列とは？
2. カスタムフォーマット文字列とは？
3. フォーマット文字列を使って数値を文字列に変換する
4. 数値を切り上げ・切り捨てして文字列に変換する

スタンダードフォーマット文字列とは？
スタンダードフォーマット文字列はアルファベット 1 文字で定義されている、標準の書式指定文字列です。

スタンダードフォーマット文字列の代表的なものには、次の 3 つがあります。

F: 固定小数点
N: 桁区切り記号つき
C: 通貨
使う時は [スタンダードフォーマット文字列] のみ、または、[スタンダードフォーマット文字列][精度指定子] のように指定します。

精度指定子は小数点以下の桁数で 0 ~ 99 までの数字が指定でき、F、N、C は指定しなかった場合デフォルトは 2 になります。

例えば、固定小数点の小数点以下なしにしたい場合は F0 で、小数点第二位までにしたい場合は F2 のように指定します。

元の数値の小数点以下の数字が指定した精度より多い場合、値は四捨五入されます。

カルチャーによって、同じスタンダードフォーマット文字列を指定しても変換後の文字列が変わってくる場合があります。

カスタムフォーマット文字列とは？
カスタムフォーマット文字列では、カスタム数値書式指定子というものを使って、数値のフォーマットを指定することができます。

カスタム数値書式指定子の代表的なものには、次のようなものがあります。

0: その桁に数字があればその数字が、なければ 0 が表示される
#: その桁に数字があればその数字が、なければ表示されない
,: 桁区切り記号を入れる
'文字列': 文字列がそのまま結果に表示される
こちらも元の数値の小数点以下の数字が指定した桁数より多い場合、値は四捨五入されます。

フォーマット文字列を使って数値を文字列に変換する
C# の数値のデータ型には ToString() の他に ToString(String)、 ToString(IFormatProvider)、 ToString(String, IFormatProvider) というオーバーロードメソッドが用意されていて、数値を文字列に変換する際にフォーマットを指定して変換することができます。

String の引数にはスタンダードとカスタムのフォーマット文字列を指定することができます。

プログラムを実行する際の CurrentCulture がわからない場合や、特定のカルチャーの結果を得たい場合は、IFormatProvider の引数に CultureInfo を渡すことでカルチャーを指定することができます。

以下は Decimal.ToString([フォーマット文字列]) を使って、数値をフォーマットされた文字列に変換するサンプルコードです。

実行される場合は、using に以下の二つを追加してください。

using System.Diagnostics;
using System.Globalization;
decimal d = 156256.799m;

Debug.WriteLine(d.ToString("----- スタンダードフォーマット文字列 -----"));
Debug.WriteLine(d.ToString("-- F --"));
Debug.WriteLine(d.ToString("F")); // 156256.80 (default:2)
Debug.WriteLine(d.ToString("F0")); // 156257
Debug.WriteLine(d.ToString("F1")); // 156256.8
Debug.WriteLine(d.ToString("F2")); // 156256.80

Debug.WriteLine(d.ToString("-- N --"));
Debug.WriteLine(d.ToString("N")); // 156,256.80 (default:2)
Debug.WriteLine(d.ToString("N0")); // 156,257
Debug.WriteLine(d.ToString("N1")); // 156,256.8
Debug.WriteLine(d.ToString("N2")); // 156,256.80

Debug.WriteLine(d.ToString("-- C --"));
CultureInfo cultureJP = CultureInfo.CreateSpecificCulture("ja-JP");
Debug.WriteLine(d.ToString("C", cultureJP)); // Y156,257

CultureInfo cultureUS = CultureInfo.CreateSpecificCulture("en-US");
Debug.WriteLine(d.ToString("C", cultureUS)); // $156,256.80

Debug.WriteLine(d.ToString("----- カスタムフォーマット文字列 -----"));
Debug.WriteLine(d.ToString("0")); // 156257
Debug.WriteLine(d.ToString("0.00")); // 156256.80
Debug.WriteLine(d.ToString("#.##")); // 156256.8
Debug.WriteLine(d.ToString("#,0.00")); // 156,256.80
Debug.WriteLine(d.ToString("0,0'円'")); // 156,257円
C# で数値をフォーマットされた文字列に変換する 1

C# で数値をフォーマットされた文字列に変換する 2

また、String.Format メソッドでもフォーマット文字列を使うことができます。

decimal d = 156256.799m;

Debug.WriteLine(string.Format("{0:F0}", d)); // 156257
Debug.WriteLine(string.Format("{0:F2}", d)); // 156256.80

Debug.WriteLine(string.Format("{0:0}", d)); // 156257
Debug.WriteLine(string.Format("{0:#.##}", d)); // 156256.8
C# で数値をフォーマットされた文字列に変換する 3

数値を切り上げ・切り捨てして文字列に変換する
フォーマット文字列を使った方法は、指定した桁に四捨五入されて文字列に変換されます。

切り上げ・切り捨てしたい場合は、文字列に変換する前に、先に数値を切り上げ・切り捨てする必要があります。

小数点以下切り上げ、小数点以下切り捨て、小数点第二位で切り上げ、小数点第二位で切り捨てするサンプルコードを載せておきます。

decimal d = 156256.799m;

decimal d1RoundUp = Math.Ceiling(d);
Debug.WriteLine(d1RoundUp.ToString("F0")); // 156257

decimal d1RoundDown = Math.Floor(d);
Debug.WriteLine(d1RoundDown.ToString("F0")); // 156256

decimal d2RoundUp = Math.Ceiling(d * 100) / 100;
Debug.WriteLine(d2RoundUp.ToString("F2")); // 156256.80

decimal d2RoundDown = Math.Floor(d * 100) / 100;
Debug.WriteLine(d2RoundDown.ToString("F2")); // 156256.79
C# で数値をフォーマットされた文字列に変換する 4

切り上げの時は Math.Ceiling、切り捨ての時は Math.Floor を使います。

小数点以下切り上げ・切り捨てしたい時は Math.Ceiling・Math.Floor を使い、数値を切り上げ・切り捨てしてから変換すれば OK です。

それ以外の時は、数値を切り上げ・切り下げの後で残したい桁が整数部の一の位になるようにしてから、Math.Ceiling・Math.Floor を使い、その後最初かけた値と同じ値で割ることによって元に戻しています。

以上、C# で数値をフォーマットされた文字列に変換する方法でした。

Visual Studio のフォントを変更する方法

Wed, 18 Sep 2019 13:42:00 GMT

Visual Studio のフォントを変更する方法

Visual Studio のフォントを変更したい
Visual Studio ではエディタやウインドウなどのフォントや文字のサイズを自由に変更することができます。

Visual Studio の言語を英語から日本語に変更すると、テキストエディターのフォントが「 MS ゴシック」に変更されてしまいました。

Visual Studio のフォントを変更する方法 0

好みの問題ですが、私は「 MS ゴシック」じゃないほうがいいので、フォントを「 Consolas 」に変更しようと思います。

Visual Studio のフォントを変更する方法
フォントを変更するには、まず [ツール] メニューから [オプション] 画面を開きます。

Visual Studio のフォントを変更する方法 1

左側で [フォントおよび色] をクリックすると、右側にフォントや色の設定画面が表示されます。

Visual Studio のフォントを変更する方法 2

普段コードを書くところは「テキストエディター」なので、「 MS ゴシック」が選ばれていることがわかります。

[設定の表示] 箇所で、フォントや色を変更したいウインドウなどを選択します。表示項目ごとでもフォントを設定可能です。

Visual Studio のフォントを変更する方法 3

今回は「テキストエディター」のフォントを「 Consolas 」に変更し、[OK] をクリックします。

Visual Studio のフォントを変更する方法 4

「テキストエディター」のフォントが「 Consolas 」になりました。

Visual Studio のフォントを変更する方法 5

選択中のフォントと違うフォントが使われてしまっている場合は？
まれに、ここで設定されているフォントと違うフォントが使われてしまっていることがあります。

そんな時は、フォントの設定画面で一旦他のフォントを選んで [OK] をクリックし、もう一度元のフォントを選びなおすことで、正しくフォントの設定が反映されました。

C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する

Fri, 19 Apr 2019 00:24:00 GMT

C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する

ストアードプロシージャを実行して値を取得する
前回「C# でストアードプロシージャの結果を SqlDataReader を使って取得する」では、SqlDataReader を使ってアストアードプロシージャの結果を取得しました。

今回は、SqlDataAdapter を使って、ストアードプロシージャを実行して値を取得してみましょう。

SqlDataAdapter で結果を取得する
SqlDataAdapter を使って、ストアードプロシージャの返す結果セットを DataSet に保存してみましょう。

Test データベースにこのような Student テーブルがあります。

C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する 1

次のストアードプロシージャを実行して、Student テーブルから Gender を指定してデータを取得してみましょう。

C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する 2

以下のコードで、ストアードプロシージャを実行して、結果を SQL Server データベースからデータを取得することができます。

string connString = ConfigurationManager.ConnectionStrings["DB1"].ConnectionString;

DataSet ds = new DataSet();
using (SqlConnection conn = new SqlConnection(connString))
{
SqlCommand comm = new SqlCommand("uspTest1", conn);
comm.CommandType = CommandType.StoredProcedure;
comm.Parameters.AddWithValue("@Gender", "M");

SqlDataAdapter da = new SqlDataAdapter(comm);
da.Fill(ds);
}
C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する 3

config ファイルから値を取得するのに System.Configuration、DataSet や CommandType を使うのにSystem.Data、SqlConnection や SqlDataAdapter 等を使うのには System.Data.SqlClientが必要ですので、using ディレクティブで追加しておきます。

config ファイルからの接続文字列取得の方法を確認したい場合はこちらをご覧ください。
C# - データベースの接続文字列を App.config から取得する

このコードで行っている処理の流れは次の通りです。

接続文字列をコンストラクターに渡して SqlConnection を生成する。
ストアドプロシージャ名とコネクションをコンストラクターに渡して SqlCommand を生成する。
CommandType に StoredProcedure を設定する。
AddWithValue で Gender をコマンドのパラメータに追加する。
SqlCommand コンストラクターに渡して、SqlDataAdapter を生成する。
SqlDataAdapter の Fill メソッドで DataSet にストアードプロシージャの実行結果を保存する。
SqlDataAdapter の Fill メソッドは、コネクションが close の状態で呼ばれた時は、コネクションを　open してデータを取得し、close してくれるので、SqlDataAdapter の時のように事前に open しなくても大丈夫です。

最後のデータ取得の箇所以外はほぼ SqlDataReader と同じですが、SqlDataReader と SqlDataAdapter の違いが気になる方はこちらご覧ください。
SqlDataReader と SqlDataAdapter の違いと使い分け

実行して、DataSet の中身を確認すると、ストアドプロシージャの実行結果が入っていますね。

C# でストアードプロシージャの結果を SqlDataAdapter を使って取得する 4

今回のストアードプロシージャは結果セットをひとつしか返さないので、DataSet の代わりに DataTable を Fill メソッドに渡しても大丈夫です。

C# でストアードプロシージャの結果を SqlDataReader を使って取得する

Fri, 19 Apr 2019 00:21:00 GMT

C# でストアードプロシージャの結果を SqlDataReader を使って取得する

ストアードプロシージャを実行して値を取得する
前回「SqlDataReader を使って SQL Server データベースから値を取得する」では、SqlDataReader を使ってアドホッククエリーの結果を取得しました。

SQL Server を使ってシステム開発をしていると、アドホッククエリーよりもストアードプロシージャを使うことが多いと思います。

今回は、SqlDataReader を使って、ストアードプロシージャを実行して値を取得してみましょう。

SqlDataReader で結果を取得する
SqlDataReader を使ってストアードプロシージャを実行して、データベースから取得したデータを読んで、コンソールに書き出してみましょう。

Test データベースにこのような Student テーブルがあります。

C# でストアードプロシージャの結果を SqlDataReader を使って取得する 1

次のストアードプロシージャを実行して、Student テーブルから Gender を指定してデータを取得してみましょう。

C# でストアードプロシージャの結果を SqlDataReader を使って取得する 2

以下のコードで、ストアードプロシージャを実行して、結果を SQL Server データベースからデータを取得することができます。

string connString = ConfigurationManager.ConnectionStrings["DB1"].ConnectionString;

using (SqlConnection conn = new SqlConnection(connString))
{
conn.Open();

SqlCommand comm = new SqlCommand("uspTest1", conn);
comm.CommandType = CommandType.StoredProcedure;
comm.Parameters.AddWithValue("@Gender", "M");

using (SqlDataReader dr = comm.ExecuteReader())
{
while (dr.Read())
{
Console.WriteLine(string.Format("{0}: {1} {2}",
dr["StudentNo"],
dr["FirstName"],
dr["LastName"]));
}
}
}
C# でストアードプロシージャの結果を SqlDataReader を使って取得する 3

config ファイルから値を取得するのに System.Configuration、CommandType を使うのにSystem.Data、SqlDataReader を使うのには System.Data.SqlClientが必要ですので、using ディレクティブで追加しておきます。

config ファイルからの接続文字列取得の方法を確認したい場合はこちらをご覧ください。
C# - データベースの接続文字列を App.config から取得する

このコードで行っている処理の流れは次の通りです。

接続文字列をコンストラクターに渡して SqlConnection を生成する。
コネクションを open する。
ストアドプロシージャ名とコネクションをコンストラクターに渡して SqlCommand を生成する。
CommandType に StoredProcedure を設定する。
AddWithValue で Gender をコマンドのパラメータに追加する。
SqlCommand の ExecuteReader メソッドを呼んで、SqlDataReader を生成する。
SqlDataReader の Read メソッドを While ループで実行することで、1 行ずつ読み込む。
読んだ行をコンソールにフォーマットして書き出す。

アドホッククエリーの時との違いは SqlCommand を生成する際にストアドプロシージャ名を渡して、CommandType に StoredProcedure を設定するところです。

SqlDataReader の Read メソッドはまだ行がある時は true、もうない時は　false を返してくれるので、While(dr.Read()) としておけば全行読み終わった時点で while ループを抜けてくれます。

SqlConnection や SqlDataReader は using ステートメントを使っておかないと、Exception でコードパスが飛んだ時に、Close し忘れる可能性がでてきてしまいますので、using を使いましょう。

こちらが実行結果です！

C# でストアードプロシージャの結果を SqlDataReader を使って取得する 4

C# で SqlDataReader を使って SQL Server データベースから値を取得する

Thu, 28 Feb 2019 22:52:00 GMT

C# で SqlDataReader を使って SQL Server データベースから値を取得する

SQL Server データベースから値を取得する
SqlDataReader はデータベースから取得したレコードを順番に読んでいくのに便利なクラスです。

今回は、SqlDataReader の簡単な使い方についてです。

SqlDataReader によるデータの取得
SqlDataReader を使ってデータベースから取得したデータを読んで、コンソールに書き出してみましょう。

Test データベースの Student テーブルからデータを取得する、次ようなクエリーがあります。

C# で SqlDataReader を使って SQL Server データベースから値を取得する 1

以下のコードで、クエリーの結果を SQL Server データベースからデータを取得することができます。

string connString = ConfigurationManager.ConnectionStrings["DB1"].ConnectionString;
string queryString = "SELECT StudentID, FirstName, LastName FROM Student;";

using (SqlConnection conn = new SqlConnection(connString))
{
SqlCommand comm = new SqlCommand(queryString, conn);
conn.Open();

using (SqlDataReader dr = comm.ExecuteReader())
{
while (dr.Read())
{
Console.WriteLine(string.Format("{0}: {1} {2}",
dr["StudentID"],
dr["FirstName"],
dr["LastName"]));
}
}
}
C# で SqlDataReader を使って SQL Server データベースから値を取得する 2

SqlDataReader を使うのには System.Data.SqlClient、config ファイルから値を取得するのに System.Configuration が必要ですので、using ディレクティブで追加しておきます。

config ファイルからの接続文字列取得の方法を確認したい場合はこちらをご覧ください。
C# - データベースの接続文字列を App.config から取得する

このコードで行っている処理の流れは次の通りです。

接続文字列をコンストラクターに渡して SqlConnection を生成する。
アドホック・クエリとコネクションをコンストラクターに渡して SqlCommand を生成する。
コネクションを open する。
SqlCommand の ExecuteReader メソッドを呼んで、SqlDataReader を生成する。
SqlDataReader の Read メソッドを While ループで実行することで、1 行ずつ読み込む。
読んだ行をコンソールにフォーマットして書き出す。

SqlDataReader の Read メソッドはまだ行がある時は true、もうない時は　false を返してくれるので、While(dr.Read()) としておけば全行読み終わった時点で while ループを抜けてくれます。

SqlConnection や SqlDataReader は using ステートメントを使っておかないと、Exception でコードパスが飛んだ時に、Close し忘れる可能性がでてきてしまいますので、using を使いましょう。

こちらが実行結果です！

C# で SqlDataReader を使って SQL Server データベースから値を取得する 3

SqlDataReader と SqlDataAdapter の違いと使い分け

Tue, 26 Feb 2019 19:36:00 GMT

SqlDataReader と SqlDataAdapter の違いと使い分け

SqlDataReader と SqlDataAdapter の違い
SQL Server データベースからデータを取得する際には、SqlClient の SqlDataReader クラスか SqlDataAdapter クラスが良く使われます。

ここでは、SqlDataReader と SqlDataAdapter の違いについて見てみましょう。

SqlDataReader クラス
SqlDataReader と SqlDataAdapter の違いと使い分け 1

SqlDataReader は SQL Server データベースから取得したレコードを前から順番に読んで行くのに使われます。

1 行 1 行処理するので、SqlDataAdapter と比べて速く、メモリーの使用量も少なくてすみます。

データを全て取得するのを待たなくても取得したレコードを使って他の処理をすることができます。

ですが、SqlDataReader が使われている間はコネクションは open のままの状態になります。

その SqlDataReader を close するまで、同じコネクションで他のデータを取得したりすることができませんので、使い終わったらすぐに close しましょう。

SqlDataAdapter クラス
SqlDataReader と SqlDataAdapter の違いと使い分け 2

SqlDataAdapter の Fill メソッドを使うと、SQL Server から送られてきたデータをがばっと DataSet や DataTable に保存することができます。

データを全て取得し終わるまで他の処理はできません。

処理にオーバーヘッドがあるので、SqlDataReader よりもメモリを使います。

私は普段使わないですが、SqlDataAdapter のメソッドを使って、データベースへデータを保存することも可能です。

SqlDataAdapter の Fill メソッドは、コネクションが close の状態で呼ばれた時は、コネクションを　open して、データを取得して、close します。コネクションが open の状態で呼ばれた時は、データを取得した後、そのまま open にしておきます。

SqlDataReader と SqlDataAdapter の使い分け
SqlDataReader と SqlDataAdapter の使い分けですが、上記の違いをふまえて、状況に応じて使えばよいと思います。

データベースで取得したデータを DataSet や DataTable に保持して、その後の処理を行いたいような時は、SqlDataAdapter を使うのが便利だと思います。

前から順番に読んで処理していくだけで良かったり、DataSet や DataTable に取得したデータを保存する必要がないような時は SqlDataReader のほうが速くて良いと思います。

SqlDataReader の Close について
先ほど書いたように、SqlDataReader は使い終わったらできるだけ早く close したほうが良いです。

SqlDataReader.Close メソッドですが、マイクソロフトのドキュメントを見ると using ステートメントを使っていても明示的に Close しているようです。

SqlDataReader と SqlDataAdapter の違いと使い分け 3

C# - データベースの接続文字列を App.config から取得する

Wed, 20 Feb 2019 01:33:00 GMT

C# - データベースの接続文字列を App.config から取得する

データベースの接続文字列
データベースの接続文字列は App.config や Web.config などの config ファイルに設定しておくことが多いと思います。

ここでは、みなさん一度は通る、データベースの接続文字列を App.config から取得する方法をご紹介します。

データベース接続文字列
データベース接続文字列はデータプロバイダーや認証方法などによって違ってきます。

Microsoft SQL Server へ接続する時のおすすめは SqlClient のプロバイダーで、例えば　「 SqlClient のプロバイダーを使って、Windows 認証で、ローカルにある MSSQLSERVER2017 という名前付きインスタンスの Test データベースに接続する」ための接続文字列は次のように設定することができます。

C# - データベースの接続文字列を App.config から取得する 1

providerName="System.Data.SqlClient"
connectionString="Server=.\MSSQLSERVER2017;Database=Test;Integrated Security=SSPI;"/>

「 SqlClient のプロバイダーを使って、SQL Server 認証で、IP アドレス 209.85.128.*** にある、デフォルトインスタンスの SQL Server の Test データベースに接続する」ための接続文字列は次のように設定することができます。

C# - データベースの接続文字列を App.config から取得する 2

providerName="System.Data.SqlClient"
connectionString="Server=209.85.128.***;Database=Test;Uid=sa;Pwd=*******"/>

App.config からデータベースの接続文字列を取得する
先ほどのようなデータベースの接続文字列を App.config ファイルから取得してみましょう。

ConfigurationManager クラスを使いたいので参照に System.Configuration を追加します。

ソリューションエクスプローラーの [参照] を選択して右クリックし [参照の追加] を選択します。

C# - データベースの接続文字列を App.config から取得する 3

参照マネージャーの画面が出てくるので、左側で [アセンブリ] を選択し、検索するなどして System.Configuration を見つけて選択し、[OK] をクリックします。

C# - データベースの接続文字列を App.config から取得する 4

C# - データベースの接続文字列を App.config から取得する 5

参照を追加したら、using ディレクティブで、System.Configuration を指定しておきます。

using System.Configuration;
C# - データベースの接続文字列を App.config から取得する 6

そうすれば、次のようにデータベース接続文字列を取得できます。

string db = ConfigurationManager.ConnectionStrings["DB1"].ConnectionString;
C# - データベースの接続文字列を App.config から取得する 7

C# で日付をフォーマットされた文字列に変換する

Tue, 15 Jan 2019 01:00:00 GMT

C# で日付をフォーマットされた文字列に変換する

日付をフォーマットされた文字列に変換する
DateTime 型の値をフォーマットされた文字列に変換したい時、よくありますよね。

ここでは、日付を文字列に変化する際に良く使うフォーマットの例を書いておこうと思います。

DateTime.ToString([フォーマット文字列])で変換
DateTime.ToString() メソッドにフォーマット文字列を渡して、文字列に変換します。

DateTime d = DateTime.ParseExact("2019-02-01 20:05:06.401",
"yyyy-MM-dd HH:mm:ss.fff",
CultureInfo.InvariantCulture);

Debug.WriteLine(d.ToString("yyyy-MM-dd HH:mm:ss.fff")); // 2019-02-01 20:05:06.401
Debug.WriteLine(d.ToString("yyyy/MM/dd HH:mm:ss")); // 2019/02/01 20:05:06
Debug.WriteLine(d.ToString("yyyy/M/d HH:mm:ss")); // 2019/2/1 20:05:06
Debug.WriteLine(d.ToString("yy/M/d HH:mm:ss")); // 19/2/1 20:05:06
Debug.WriteLine(d.ToString("yyyyMMddHHmmss")); // 20190201200506
Debug.WriteLine(d.ToString("MM/dd/yyyy HH:mm:ss")); // 02/01/2019 20:05:06
C# で日付をフォーマットされた文字列に変換する 1

同じフォーマット文字列を渡しても、カルチャーによって変換後の文字列が変わってくる場合があります。

例えば、CultureInfo.CurrentCulture が日本 (ja-JP)の場合と、アメリカ (en-US)の場合では次のように違います。

DateTime d = DateTime.ParseExact("2019-02-01 20:05:06.401",
"yyyy-MM-dd HH:mm:ss.fff",
CultureInfo.InvariantCulture);

// CurrentCulture を日本 (ja-JP) に設定する
CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture("ja-JP");
Debug.WriteLine(d.ToString("----- ja-JP -----"));
Debug.WriteLine(d.ToString("d")); // 2019/02/01
Debug.WriteLine(d.ToString("G")); // 2019/02/01 20:05:06
Debug.WriteLine(d.ToString("yyyy/MM/dd hh:mm:ss tt")); // 2019/02/01 08:05:06 午後
Debug.WriteLine(d.ToString("MMM")); // 2
Debug.WriteLine(d.ToString("MMMM")); // 2月
Debug.WriteLine(d.ToString("ddd")); // 金
Debug.WriteLine(d.ToString("dddd")); // 金曜日

// CurrentCulture をアメリカ (en-US) に設定する
CultureInfo.CurrentCulture = CultureInfo.CreateSpecificCulture("en-US");
Debug.WriteLine(d.ToString("----- en-US -----"));
Debug.WriteLine(d.ToString("d")); // 2/1/2019
Debug.WriteLine(d.ToString("G")); // 2/1/2019 8:05:06 PM
Debug.WriteLine(d.ToString("MM/dd/yyyy hh:mm:ss tt")); // 02/01/2019 08:05:06 PM
Debug.WriteLine(d.ToString("MMM")); // Feb
Debug.WriteLine(d.ToString("MMMM")); // February
Debug.WriteLine(d.ToString("ddd")); // Fri
Debug.WriteLine(d.ToString("dddd")); // Friday
C# で日付をフォーマットされた文字列に変換する 2

最後にカルチャーを指定して変換したい場合は次のように指定できます。

この例では、ドイツ(de-DE)の CultureInfoを生成して、第二引数として DateTime.ToString() メソッドに渡しています。

DateTime d = DateTime.ParseExact("2019-02-01 20:05:06.401",
"yyyy-MM-dd HH:mm:ss.fff",
CultureInfo.InvariantCulture);

// カルチャーを指定して変換する
Debug.WriteLine(d.ToString("G",
CultureInfo.CreateSpecificCulture("de-DE"))); // 01.02.2019 20:05:06
C# で日付をフォーマットされた文字列に変換する 3

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法

Wed, 05 Dec 2018 01:45:00 GMT

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法

ユーザー定義テーブル型変数
複数のレコードを一度にストアドプロシージャに渡して処理したい時には、SQL Server のユーザー定義テーブル型を使うと便利です。

SQL Server 入門の「ユーザー定義テーブル型変数を使って、ストアドプロシージャに複数のレコードを一度に渡す」では、ユーザー定義テーブル型変数と、それを引数として受け取るストアードプロシージャを作り、SQL Server Management Studio から実行してみました。

今回は、そこで作ったストアードプロシージャ uspStudentSave を C# から実行する方法をご紹介します。

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す
おさらいですが、実行前の Student テーブルはこのようになっています。

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法 1

ストアードプロシージャ uspStudentSave は、ユーザー定義のテーブル型変数 StudentTableType を引数として受けとって、Student テーブルの更新（Inesrt/Update/Delete）を行います。

StudentID は Identity カラムで、新規レコードには StudentID = 0 がクライアントプログラムで設定されているものとします。

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法 2

生成するスクリプトは「ユーザー定義テーブル型変数を使って、ストアドプロシージャに複数のレコードを一度に渡す」を参照してください。

今回は Student テーブルから値を引いてきて、それを変更し、保存してみましょう。

まず、以下のストアドプロシージャ uspStudentSelectを実行して、Student テーブルから全レコードを取得します。

CREATE PROCEDURE uspStudentSelect
AS
BEGIN

SELECT StudentID,
FirstName,
LastName,
Birthday,
Gender
FROM Student;

END
次に、StudentID = 1 の LastName を Yamamoto に変更し、StudentID = 2 のレコードを削除し、新しい Student レコードを一行追加します。

そして、最後に uspStudentSave を実行して変更を保存するコードは以下の通りです。

// Student テーブルのデータを取得
DataTable dtStudent = new DataTable();
using (SqlConnection conn =
new SqlConnection(ConfigurationManager.ConnectionStrings["DB"].ConnectionString))
{
conn.Open();

SqlCommand cmd = new SqlCommand("uspStudentSelect", conn);
cmd.CommandType = CommandType.StoredProcedure;

SqlDataAdapter sda = new SqlDataAdapter(cmd);
sda.Fill(dtStudent);
}

// Student テーブルのデータを変更・削除・新規挿入
DataRow[] dr1 = dtStudent.Select("StudentID = 1");
if(dr1.Length > 0)
{
dr1[0]["LastName"] = "Yamamoto";
}

DataRow[] dr2 = dtStudent.Select("StudentID = 2");
if (dr2.Length > 0)
{
dr2[0].Delete();
}

DataRow drS = dtStudent.NewRow();
drS["StudentID"] = 0;
drS["FirstName"] = "Ryoko";
drS["LastName"] = "Okamoto";
drS["Birthday"] = "1981-08-08";
drS["Gender"] = "F";
dtStudent.Rows.Add(drS);

dtStudent.AcceptChanges();

// Student テーブルのデータを保存
using (SqlConnection conn =
new SqlConnection(ConfigurationManager.ConnectionStrings["DB"].ConnectionString))
{
conn.Open();

SqlCommand cmd = new SqlCommand("uspStudentSave", conn);
cmd.CommandType = CommandType.StoredProcedure;

SqlParameter tvpParam = cmd.Parameters.AddWithValue("@StudentTable", dtStudent);
tvpParam.SqlDbType = SqlDbType.Structured;

cmd.ExecuteNonQuery();
}
C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法 3

ユーザー定義のテーブル型を uspStudentSave に渡しているのは緑で囲まれた部分です。

値の入った DataTable を AddWithValue で追加して、その SqlParameter の SqlDbType を Structured に設定しています。

注意する点は、値の入った DataTable はユーザー定義テーブル型と構造が同じでないとエラーになります。

今回の場合ですと、 uspStudentSelect が返すカラムがユーザー定義テーブル型と違うとエラーになります。

ユーザー定義テーブル型と同じカラム＆型であれば、以下のような感じで DataTable を作って渡しても大丈夫です。

DataTable dtStudent = new DataTable();
dtStudent.Columns.Add("StudentID", typeof(Int32));
dtStudent.Columns.Add("FirstName", typeof(String));
dtStudent.Columns.Add("LastName", typeof(String));
dtStudent.Columns.Add("Birthday", typeof(DateTime));
dtStudent.Columns.Add("Gender", typeof(String));

DataRow drS1 = dtStudent.NewRow();
drS1["StudentID"] = 1;
drS1["FirstName"] = "Taro";
drS1["LastName"] = "Yamada";
drS1["Birthday"] = "1980-02-15";
drS1["Gender"] = "M";
dtStudent.Rows.Add(drS1);

上のコードを実行してみました。こちらは保存前の dtStudent の値です。

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法 4

実行後の Student テーブルの値は以下の通りです。期待通りに更新されていますね。

C# からユーザー定義テーブル型変数をストアードプロシージャに渡す方法 5

C# - ストアードプロシージャの OUTPUT パラメーターの値を取得する方法

Sat, 01 Dec 2018 02:20:00 GMT

C# - ストアードプロシージャの OUTPUT パラメーターの値を取得する方法

ストアードプロシージャーの OUTPUT パラメーターの値を取得する
今回は C# から OUTPUT パラメーターのあるストアードプロシージャの実行して、実行後に OUTPUT パラメーターの値を取得する方法です。

OUTPUT パラメーターのあるストアードプロシージャ
例えば、このようなシンプルな Test テーブルがあります。

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 1

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 2

そして、この uspTestInsert というストアードプロシージャでは、その Test テーブルにレコードを挿入して、挿入されたレコードの、IDENTITY プロパティのプライマリーキーカラムである TestID の値を、@TestID という名前の OUTPUT パラメターにセットします。

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 3

SQL Server Management Studio から実行するとこんな感じです。

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 4

C# から OUTPUT パラメーターの値を取得する
C# から uspTestInsertを実行して、 OUTPUT パラメーターである @TestID の値を次のように取得することができます。

using (SqlConnection conn =
new SqlConnection(ConfigurationManager.ConnectionStrings["DB"].ConnectionString))
{
conn.Open();

SqlCommand cmd = new SqlCommand("uspTestInsert", conn);
cmd.CommandType = CommandType.StoredProcedure;
cmd.Parameters.AddWithValue("@TestNameEn", "English 2");
cmd.Parameters.AddWithValue("@TestNameJp", "英語２");

cmd.Parameters.Add("@TestID", SqlDbType.Int);
cmd.Parameters["@TestID"].Direction = ParameterDirection.Output;

cmd.ExecuteNonQuery();

int? testID = null;
if (cmd.Parameters["@TestID"].Value != DBNull.Value)
{
testID = Convert.ToInt32(cmd.Parameters["@TestID"].Value);
}
}
OUTPUT パラメーターは AddWithValue ではなく Add で追加して、Parameter の Direction を Output に設定しています。

ストアードプロシージャ実行後に、その SqlParameter.Value で値を取得できます。

実行してみると、Test テーブルにレコードが挿入され、そのレコードの TestID = 5 を取得することができましたね。

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 5

ストアードプロシージャの OUTPUT パラメーターの値を取得する方法 6

C# の TransactionScope のタイムアウトの設定方法

Wed, 14 Nov 2018 02:24:00 GMT

C# の TransactionScope のタイムアウトの設定方法

C# の TransactionScope のタイムアウト
前回、こちらの記事で　「TransactionScope（トランザクションスコープ）の使い方」をご説明しました。

基本的に長い処理をトランザクションとして実行すると、他のトランザクションをブロックしますので、なるべく長くならないようにしたほうが良いとおもいます。

ですが、時には仕方がない時もありますよね。

TransactionScope にもタイムアウトがあり、ConnectionTimeout や CommandTimeout を伸ばしていても、TransactionScope のタイムアウトの時間になると、Transaction Timeout のエラーになって、トランザクションが強制終了されてしまいます。

デフォルトの TransactionScope タイムアウトは 60 秒です。

試しに、uspTest というストアードプロシージャーに WAITFOR DELAY で 1 分 5 秒スリープさせるようにしておきます。

C# の TransactionScope のタイムアウトの設定方法 1

そして、C# から CommandTimeout　を 120 秒にして実行すると、1 分ちょっとで次のようにトランザクションタイムアウト（Transaction Timeout）になります。

C# の TransactionScope のタイムアウトの設定方法 2

という訳で、今回は TransactionScope のタイムアウトの設定方法をご紹介します。

TransactionScope のタイムアウトの設定方法
トランザクションタイムアウトの設定方法のひとつは、TransactionScope のオブジェクトを生成する際にコンストラクターでタイムアウトを指定することです。

タイムアウト値を受け取るコンストラクターは何個かありますが、タイムアウトだけを指定したいので次のコンストラクターを使います。

TransactionScope(TransactionScopeOption, TimeSpan)

TransactionScopeOption には default の Required を指定しておきます。

トランザクションスコープのタイムアウトを 120 秒に設定する場合、コードは次のようになります。

using (TransactionScope scope =
new TransactionScope(TransactionScopeOption.Required,
TimeSpan.FromSeconds(120)))
C# の TransactionScope のタイムアウトの設定方法 3

catch セクションには来ず、uspTest の実行が成功しました。

C# - TransactionScope（トランザクションスコープ）の使い方

Mon, 23 Apr 2018 18:10:00 GMT

C# - TransactionScope（トランザクションスコープ）の使い方

C# のトランザクションとは
ここで言う「トランザクション」とは、一連の処理単位のことです。

トランザクション内の処理は、全てが成功した時のみ確定され、処理の途中でエラーが起きた場合は、そこまでの処理をロールバックして、トランザクション処理実行前の状態まで戻ります。

データベース側でトランザクションに入れられる時は良いですが、複数のデータベースを更新する必要があったり、途中でクライアント側処理を挟む必要があったりと、データベース側ではトランザクションに入れられない時もあると思います。

C# では、TransactionScope クラスを使って、簡単にデータベースに関連する処理をコード側からトランザクションとして処理することができます。

エラーが出るとロールバックしてくれるので、データの整合性を保つのにとても便利です。

System.Transactions を [参照] に追加する
まず、TransactionScope を使いたいので、参照に System.Transactions を追加します。

ソリューションエクスプローラーで [参照] を右クリックし [参照の追加] をクリックします。

C# - トランザクションスコープの使い方 1

[アセンブリ] の [フレームワーク] から System.Transactions を選択し、[OK] をクリックします。

C# - トランザクションスコープの使い方 2

[参照] に System.Transactions が追加されました。

C# - トランザクションスコープの使い方 3

以下の using ディレクティブを追加しておいてください。

using System.Transactions;
C# - トランザクションスコープの使い方 4

TransactionScope を使ってトランザクションを実行する
違うサーバにあるデータベースとの分散トランザクションも可能ですが、設定がいろいろと必要になりますので、今回は同じ PC にインストールされた別のインスタンスのデータベースに接続して試します。

同じ PC 上にある MSSQLSERVER2017 という名前付きインスタンスと、SQLEXPRESS という名前付きインスタンス上の Test データベースに接続します。

App.config ファイルはこんな感じです。

connectionString="Server=.\MSSQLSERVER2017;Database=Test;Uid=sa;Pwd=*******"/>
connectionString="Server=.\SQLEXPRESS;Database=Test;Uid=sa;Pwd=*******" />

C# - トランザクションスコープの使い方 5

次のコードで、TransactionScope を使って、両方のデータベースに存在する uspTest というストアドプロシージャを実行します。

using (TransactionScope scope = new TransactionScope())
{
using (SqlConnection conn1 =
new SqlConnection(ConfigurationManager.ConnectionStrings["DB1"].ConnectionString))
{
conn1.Open();

SqlCommand cmd1 = new SqlCommand("uspTest", conn1);
cmd1.CommandType = CommandType.StoredProcedure;
cmd1.Parameters.AddWithValue("ExecutedFrom", "Test1");
cmd1.ExecuteNonQuery();

using (SqlConnection conn2 =
new SqlConnection(ConfigurationManager.ConnectionStrings["DB2"].ConnectionString))
{
conn2.Open();

SqlCommand cmd2 = new SqlCommand("uspTest", conn2);
cmd2.CommandType = CommandType.StoredProcedure;
cmd2.Parameters.AddWithValue("ExecutedFrom", "Test2");
cmd2.ExecuteNonQuery();
}
}

scope.Complete();
}
C# - トランザクションスコープの使い方 6

scope.Complete(); まで到達すれば、変更が反映されますが、エラーや return などで、そこに到達する前に TransactionScope のスコープを抜けると、データベースへの変更は自動的にロールバックされます。

uspTest の内容はこんな感じで、実行されると TestResult テーブルに @ExecutedFrom と実行時間がインサートされるだけです。

C# - トランザクションスコープの使い方 7

C# - トランザクションスコープの使い方 8

このコードを実行すると、次のように両方のデータベースの uspTest が実行され、TestResult テーブルにレコードがインサートされました。

C# - トランザクションスコープの使い方 9

TransactionScope の Isolation レベル（トランザクション分離レベル）は指定可能ですが、デフォルトは Serializable （直列化可能）になっています。

Serializable （直列化可能）は一番強く、安全な分離レベルです。このトランザクションが読んだデータは、このトランザクションが終わるまで他のトランザクションが変更することができません。また、他のトランザクションがこのトランザクションに影響するような新しいデータを挿入することもできません。

その分、一番他のトランザクションをブロックしますので、この Isolation レベルで長い処理をトランザクションとして実行しないように気をつけてくださいね！

MSDTC on server [サーバー名] is unavailable のエラーが出た場合
2 つめのデータベースの接続を Open した時に「 MSDTC on server [サーバー名] is unavailable 」というエラーが出た場合は、Distributed Transaction Coordinator サービスが停止している可能性があります。

C# - トランザクションスコープの使い方 10

検索で Services.msc と入力して Services を起動してください。

C# - トランザクションスコープの使い方 12

そこで Distributed Transaction Coordinator を探し、停止している場合は右クリックでサービスを開始した後で、再度実行してみてください。

C# - トランザクションスコープの使い方 11

C# で DataTable から DISTINCT な値を取得する

Tue, 17 Apr 2018 00:05:00 GMT

C# で DataTable から DISTINCT な値を取得する

DataTable から DISTINCT な値を取得する
DataTable に値が入っていて、その中の特定のカラムの DISTINCT な値を取得したいような時ありませんか？

データベース側でやるならば SELECT DISTINCT [カラム名1], [カラム名2] FROM [テーブル名]... のような感じで簡単にできますよね。

ここでは、C# 側で DataTable から DISTINCT な値を取得して、その結果を DataTable として取得したい際に使えるコードをご紹介します。

例えば以下のような dt という名前の DataTable があるとします。

C# で DataTable から DISTINCT な値を取得する 1

この中で、Department カラムと GroupName カラムの DISTINCT な値を持つ DataTable を取得してみましょう。

DataView の ToTable メソッドを使う
Linq を使ったり、いろいろな方法があるかと思いますが、ここでは DataView の ToTable メソッドを使います。

構文は DataView.ToTable (Boolean, String[]) で、一つ目の引数に true を渡すことで、String[] で指定したカラムの DISTINCT な値を持つ新しい DataTable を取得することができます。

先ほどの dt という名前の DataTable から次のコードで、 Department カラムと GroupName カラムの DISTINCT な値を持つ DataTable を取得することができます。

DataTable dtDistinct = dt.DefaultView.ToTable(true, "Department", "GroupName");
C# で DataTable から DISTINCT な値を取得する 2

dt の DefaultView の ToTable メソッドを使っています。

Department カラムと GroupName カラムの DISTINCT な値を持つ DataTable が取得できていますね。

また、取得できるテーブルは、dt.DefaultView.RowFilter で指定したフィルターが効きますので、必要に応じて設定してください。

C# で DataTable から DISTINCT な値を取得する 3

ちなみに ToTable メソッドは、 dt のレコードが 0 行であったり、dt.DefaultView.RowFilter の結果が 0 行の場合も 0 行のテーブルが返ってくるだけで、エラーになりません。

Visual Studio の UI を英語から日本語に変更する方法

Mon, 16 Apr 2018 17:38:00 GMT

Visual Studio の UI を英語から日本語に変更する方法

Visual Studio の UI の言語
Visual Studio の UI の言語は、使用している Windows OS の言語がデフォルトで使用されます。

ここでは、日本語以外の Windows OS の環境で、Visual Studio の UI を日本語に変更する方法をご紹介したいと思います。

この記事を書いている時点の最新バージョンは Visual Studio Community 2017 なので、それを使います。

Visual Studio の UI を英語から日本語に変更する方法
今回は英語の Windows OS を使っている人が Visual Studio を日本語で使いたい時の変更方法でご説明します。

他の言語でも同じような場所に設定項目があるはずですので、英語以外の方は探してみてください。

まず、[Tools] メニューの [Options] をクリックします。

Visual Studio の UI を英語から日本語に変更する方法 1

[Options] の画面が出てきますので、左側の [International Settings] をクリックして、 [Langulage] のリストを見てみてください。

リストに日本語が既にある方は [日本語] に変更して、[OK] をクリックして下さい。

Visual Studio の UI を英語から日本語に変更する方法 2

リストに日本語がない方は、下記の「 Visual Studio の言語パックを追加する方法」で日本語を追加してから選択してください。

言語設定の変更は、再起動するまで有効になりませんよ、というメッセージが出てくるので [OK] をクリックします。

Visual Studio の UI を英語から日本語に変更する方法 11

その後、Visual Studio を再起動すると、メニューなどが日本語になります。

Visual Studio の UI を英語から日本語に変更する方法 3

Visual Studio の言語パックを追加する方法
以下のような状態で日本語がリストにない時は、Visual Studio 日本語の言語パックをインストール必要があります。

Visual Studio の UI を英語から日本語に変更する方法 4

日本語の言語パックは、Visual Studio のインストーラーから追加できます。

Visual Studio が起動していない状態で、Visual Studio のインストーラーを起動します。

Visual Studio の UI を英語から日本語に変更する方法 5

Visual Studio のインストーラーを起動したら [Modify] ボタンをクリックします。

Visual Studio の UI を英語から日本語に変更する方法 6

[Language Packs] タブをクリックし、[Japanese] をチェックし、[Modify] ボタンをクリックします。インストールには少し時間がかかります。

Visual Studio の UI を英語から日本語に変更する方法 7

インストールが終わるとこの画面に戻ってくるので[Lunch] ボタンをクリックします。

Visual Studio の UI を英語から日本語に変更する方法 9

先ほどのように [Tools] > [Options] > [International Settings] にいってみると、[日本語] が追加されていますね。

Visual Studio の UI を英語から日本語に変更する方法 10

日本語以外の Windows OS で Visual Studio のインストーラーを日本語で実行する方法

Mon, 16 Apr 2018 16:42:00 GMT

Visual Studio のインストーラーを日本語で実行する方法

Visual Studio のインストーラーの言語
Visual Studio のインストーラーの言語は、使用している Windows OS の言語がデフォルトで使用されます。

ここでは、日本語以外の Windows OS の環境で、Visual Studio のインストーラーを日本語で実行する方法をご紹介したいと思います。

この記事を書いている時点の最新バージョンは Visual Studio Community 2017 なので、それを使います。

Visual Studio Community 2017 では、日本語の Windows OS を使っていらっしゃる方は何もしなくても日本語でインストーラーが立ち上がるはずですので、そのままダウンロードした exe ファイルを実行してください。

Visual Studio のインストーラーを日本語で実行する方法
Visual Studio のインストーラーの言語を日本語にするのは簡単です。

Visual Studio Community 2017 エディションをダウンロードしたら、そのままブラウザから実行せずにコマンドプロンプトから実行します。

コマンドプロンプトを開くには、検索ボックスで cmdとタイプすると出てきます。
Visual Studio のインストーラーを日本語で実行する方法 1

そして、 >cd [ディレクトリのパス] でカレントディレクトリを移動できます。

日本語にするには、exe ファイルの名前に続けて --locale ja-JP のオプションをつけて実行します。

例えば、私の場合は、C:\Users\Tomoko\Downloads にダウンロードして、ファイル名が vs_community__1430453331.1523085517.exe だったので、次のように実行しました。

>vs_community__1430453331.1523085517.exe --locale ja-JP

Visual Studio のインストーラーを日本語で実行する方法 2

そうするとインストーラーがこのように日本語で起動します。

Visual Studio のインストーラーを日本語で実行する方法 3

インストーラーを日本語で起動すると、デフォルトで言語パックにも日本語だけにチェックが入ります。

Visual Studio のインストーラーを日本語で実行する方法 4

そのままインストールすると、Visual Studio の UI も日本語になります。

Visual Studio のインストーラーを日本語で実行する方法 5

最初の C# プログラム

Sat, 14 Apr 2018 00:51:00 GMT

最初の C# プログラム

最初の C# プログラム
前回「 C# とは？」で、C# とは何かについて軽くご説明しました。

それでは、試しに C# で簡単なプログラムを書いてみましょう。

Visual Studio の Community エディションを使いますのでインストールがまだの方はこちらをご参考にインストールしてください。
Visual Studio の Community エディションのインストール方法

Visual Stuido を起動したら、[ファイル] メニューから [新規作成] > [プロジェクト] を選択します。

最初の C# プログラム 1

[新しいプロジェクト] 画面が出てくるので [Windows フォームアプリケーション] を選択します。名前を MyFirstApp とし、保存場所は変更したければ変更してください。

その他の項目は今回はそのままで [OK] をクリックします。

最初の C# プログラム 2

そうすると、次のような画面が表示されます。どんと中央に表示されているのがフォーム (Form) というもので、これから作る画面の土台になります。

最初の C# プログラム 3

フォームにボタンをひとつ追加してみましょう。画面の左上あたりにある [ツールボックス] をクリックします。

最初の C# プログラム 4

もし左側に [ツールボックス] が出ていない場合は、メニューの [表示] > [ツールボックス] で表示できます。
最初の C# プログラム 6

[ツールボックス]が表示されたら、[すべての Windows フォーム] をクリックします。

最初の C# プログラム 5

Windows フォームのコントロールがいろいろ表示されますので、その中から [button] を選択して、フォームの上にドラッグ＆ドロップします。

最初の C# プログラム 7

最初の C# プログラム 8

追加した [button1] をダブルクリックすると、次のような Form1.cs というコードが書かれたファイルが開きます。

最初の C# プログラム 9

それでは、いよいよ最初の C# のコードを書いてみましょう！

button1_Click メソッドの中に次のコードを追加してください。

string msg = "Hello, World!";
MessageBox.Show(msg);
最初の C# プログラム 10

button1_Click メソッドは、先ほど追加した [button1] ボタンがクリックされた時に実行されるコードです。

このコードは Hello, World! と書かれたメッセージボックスを表示します。

書けたら上にある [開始] ボタンをクリックしてください。コードがビルドされ実行されます。

最初の C# プログラム 11

次のような、[button1]ボタンがひとつだけ配置された画面が立ち上がりますので、[button1] ボタンをクリックしてみてください。

最初の C# プログラム 12

Hello, World! と書かれたメッセージボックスが出てきましたね！

最初の C# プログラム 13

大きな画面に [button1] ボタンひとつで不格好ですが、これでも Windows アプリの完成です。

以下の bin フォルダーの中にある MyFirstApp.exe ファイルを .NET Framework が入っている他の PC にコピーしてもちゃんと動きますよ！

最初の C# プログラム 14

C# とは？

Sat, 14 Apr 2018 00:47:00 GMT

C# とは？

C# とは？
C# とはマイクロソフトが開発した、C 言語系のオブジェクト指向のプログラミング言語です。

C や C++、Jave をやったことがある方には、なじみやすい言語だと思います。

C# は、.NET Framework で使用できるメインのプログラミング言語です。

.NET Framework はマイクロソフトが開発した、共通言語ランタイム (CLR) と .NET Framework クラスライブラリで構成された、アプリケーション開発・実行環境です。

C# などで書かれたソースコードを中間言語にコンパイルし、それを共通言語ランタイム (CLR) が実行することによって、言語に依存しない開発環境や実行環境を提供しています。

簡単に言うと、いろんな言語でプログラムできて、どこでも動くアプリケーションにする為の仕組みです。

C# を使った開発には、マイクロソフトの統合開発環境である Microsoft Visual Studio がよく使われています。

Visual Studio には、個人開発者には無料の Community エディションも提供されています。

その Visual Studio の Community エディションを使って、C# のプログラミングを学んでいきましょう。

Visual Studio の Community エディションを使いますのでインストールがまだの方はこちらをご参考にインストールしてください。
Visual Studio の Community エディションのインストール方法
次へ最初の C# プログラム

C# プログラミング入門

Sat, 14 Apr 2018 00:41:00 GMT

C# プログラミング入門

初心者向けの C# プログラミング入門ページです。

ここにある記事を一通りざっと読んで試したら、C# プログラミングの基本は OK! となるように記事を書いていこうと思っています。

プログラミング言語の入門書では、コマンドプロンプトから実行するコンソールアプリケーションプログラムを作って言語を学ぶことが多いと思います。

このサイトでは、コンソールアプリケーションではなく、Windows フォーム (Windows Forms) というマイクロソフトの GUI ライブラリを使って、Windows アプリを作りながら C# のプログラミングを学びます。

初めて Windows フォームを使ってプログラムをする方は、すごく簡単に Windows アプリができるので、驚かれるかもしれません

Windows アプリを作るには WPF という　GUI のサブシステムを使う方法もありますが、UI の自由度が高い変わりにプログラミング経験がない方には少し複雑な部分がありますので、本サイトでは Windows フォームを使います。

それでは、C# プログラミングを学んでいきましょう。

Visual Studio という統合開発環境を使いますので、まだインストールしていない方は先にインストールしておいてください。

Visual Studio の Community エディションのインストール方法

C# とは？
最初の C# プログラム

Visual Studio の Community エディションのインストール方法

Sat, 14 Apr 2018 00:35:00 GMT

Visual Studio の Community エディションのインストール方法

Visual Studio の Community エディションのインストール方法
前回「 Microsoft Visual Studio とは？」では Visual Studio とは何かについて軽くご説明しました。

ここでは、Visual Studio の Community エディションの、簡単なインストール方法を順を追ってご紹介したいと思います。

この記事を書いている時点のの最新バージョンは Visual Studio Community 2017 なので、それをインストールします。

Microsoft SQL Server をインストールする
1. まずは以下のページから Visual Studio の Community エディションをダウンロードしましょう。

もしダウンロードページが変わってしまっている場合は、Google で「 Visual Studio　ダウンロード」で検索するとすぐに見つかると思います。
Microsoft - Visual Studio のダウンロードのページ

Visual Studio のインストール 1

2. ダウンロードした exe ファイル（vs_community*.exe）を実行すると、インストールウィザードが立ち上がるので [続行] をクリックします。

Visual Studio のインストール 2

3. 「ワークロード（必要な機能セット）」を選択します。ここでは Windows の「ユニバーサル Windows プラットホーム開発」と「.Netデスクトップ開発」を選択しました。

ワークロードは後からでもインストールできるので、ここでは気軽に選んで大丈夫です。
Visual Studio のインストール 3

英語の OS で Visual Studio を日本語で使えるようにしたい方は、ここの「Language Packs」で「Japanese」を選択しておきます。
Visual Studio のインストール 4

選択したら [インストール] をクリックします。

4. インストールが始まります。結構時間がかかるので、他のことをしてお待ちください

Visual Studio のインストール 5

5. 「再起動が必要です」と言ってきますので、Windows を再起動してください。

Visual Studio のインストール 6

6. 再起動が終わったら、スタートメニューやサーチから Visual Studio 2017 を探して起動します。

Visual Studio のインストール 7

7. 「ようこそ」画面が出てきます。もちろんサインインやサインアップしてもよいですが、ここでは「後で行う。」にしておきます。

Visual Studio のインストール 9

8. 開発環境を設定する画面が出てきます。 C# プログラミングの勉強をするので、開発設定には [Visual C#] を選んでください。配色はお好みで選んでください。

これらの設定も後から変更できますので、気楽に選んでください。
Visual Studio のインストール 10

選んだら [Visual Studio の開始] ボタンをクリックします。

Visual Studio 2017 の画面が立ち上がります。インストールはこれで完了です。

Visual Studio のインストール 11

Microsoft Visual Studio とは？

Sat, 14 Apr 2018 00:28:00 GMT

Microsoft Visual Studio とは？

Microsoft Visual Studio とは？
Microsoft Visual Studio とは、マイクロソフトが提供している統合開発環境 (IDE) です。

統合開発環境 (IDE) というのは、コードエディタやコンパイラ、デバッガなど、ソフトウエアの開発に必要ものを、まとめて便利に利用できるようにした開発環境です。

Visual Studio を使って、次のようなアプリケーションソフトウェアを開発することができます。

Windows アプリ
Web アプリ
モバイルアプリ
IoT アプリ
ゲームアプリ
Azure アプリ
特に Windows 系の開発にはなくてはならない開発環境です。

サポートされている言語には以下のようなものがあります。

C#
Visual Basic
F#
C++
HTML
JavaScript
TypeScript
Python
その中でも C# は、多くの機能を活用できるメインの言語と言われています。

昔は Visual Studio は有料のものしかなかったのですが、今では学生、個人、中小企業、非営利団体は無料で使える Community エディションが提供されています！

有料のエディションを比べるとテスト系のツールなど使えない機能もありますが、基本的な開発をするのには十分な機能が含まれています。

その Visual Studio の Community エディションを使って、C# のプログラミングを学んでいきましょう。

Visual Studio の Community エディションのインストール方法はこちらをご覧ください。
Visual Studio の Community エディションのインストールする

Visual Studio 入門

Sat, 14 Apr 2018 00:24:00 GMT

Visual Studio 入門

Microsoft Visual Studio はマイクロソフトが提供している統合開発環境 (IDE) です。

Windows アプリ、Web アプリ、モバイルアプリ、IoT アプリ等のアプリケーション開発することができます。

本サイトの「 C# プログラミング入門」でも Visual Studio を使ってプログラミングを学びます。

ここでは、Visual Studio を一度も使ったことがない方のために、Visual Studio のインストールから基本的な使い方の説明のほか、便利な機能などをご紹介します！

Visual Studio の基本設定
Microsoft Visual Studio とは？
Visual Studio の Community エディションのインストール方法
Visual Studio の各種設定
日本語以外の Windows OS で Visual Studio のインストーラーを日本語で実行する方法
Visual Studio の UI を英語から日本語に変更する方法