ぷろじぇくと、みすじら。

ASP.NET MVC Core 1.1のRazorテンプレートでC#7を使う

Created at: 2017-07-02 00:00:00Z

ASP.NET MVC Core 1.1でプロジェクトを作るとRazorテンプレート(cshtml)では利用できるC#のバージョンは6です。2017年7月時点の最新版であるところのC#7の機能を使うためにはちょっと準備が必要です。

NuGetパッケージをインストール

まず以下の二つのNuGetパッケージをインストールします。

System.ValueTuple
Microsoft.CodeAnalysis.CSharp

System.ValueTupleは入れなくてもいいといえばいいですがもちろんその場合にはValueTupleを使えません。

Razorの設定

パッケージのインストールができたら次はASP.NET MVC Coreの設定をするためにStartup.csを開きます。

ConfigureServicesメソッドに以下の行のが見つかるかと思います。

services.AddMvc();

その行を以下のように書き換えます。

services.AddMvc()
    .AddRazorOptions(options =>
    {
        options.ParseOptions = new CSharpParseOptions(LanguageVersion.Latest);
    });

AddRazorOptionsでRazorの設定をする形です。LanguageVersion列挙体にはCSharp7をはじめとしてバージョンがいろいろあるのですが大抵は最新を指すLatestでもいいような気がします。

これで完了です。あとはC# 7の構文がエラーにならなければできあがりです。

OneDrive File On-Demandについて

Created at: 2017-06-29 21:37:00Z

OneDrive File On-Demandについて先日行われたWindows Insider Meetup in Tokyo #2に飛び込みで少しお話してきました。

OneDrive On-Demandがすごい

Windows 8.1の時にもプレースホルダという機能は存在していて、その後無くなって、Windows 10 Fall Creators Updateと呼ばれる次期アップデートで復活するということになったのですがわざわざ時間をかけて復活してきたということは結構違うのでは?と思って少し調べたのがきっかけです。

記憶が定かではなく、かつ検証もしてないのですが確かWindows 8.1のプレースホルダはプログラムから直接扱おうとすると0バイトの謎ファイルになっていたような記憶があります。あくまでシェルが良しなにしてくれるショートカットに近い扱いというか。

ところが今回復活するプレースホルダはファイルシステムレベルで考慮されている感があって、互換性やシームレスさが高まることが期待されます。

余談

Windowsの開発用にGVFS(Git Virtual File System)というGitのためのファイルシステムを作ったと少し前に発表していましたが、GVFSはCreators Update以降で動作するというあたり、もしかして何かファイルシステム周りにAPIが増えたのかもという気がしています。

今までもDokanなどいわゆるFUSEのようなものがありましたが、もう少し作りやすい仕組みを整備しているのかもですね。UIもクラウドプロバイダからダウンロード中みたいな表示だったりするのでOneDrive以外のDropboxなどでも対応できるようにしてくるのかもしれません。

.NETのバージョンまとめメモ

Created at: 2017-06-09 23:55:00Z

.NET Coreとそれにまつわるバージョンはいろいろあって、多分数字が大きい方が正しいのであろうと思いつつも1.1と1.0が並行していた時期があったりとどっちを使えば…と若干混乱したことがあったので整理してみようかと。.NET Standardというものもあって頭が爆発しそうですし。

なお.NET Standardに関して詳しくは.NET Standardのページと、藤原さんの.NET Standard のおさらいがおすすめです。

バージョン一覧

2017年6月9日現在の最新の.NET Core/.NET/ASP.NET Core/ASP.NET MVC Coreのバージョンとそれに対応する.NET Standardバージョンの一覧です。

Product	Release	Name	Latest	.NET Standard
.NET Core (netcoreapp)	LTS	.NET Core 1.0	1.0.5 (SDK 1.0.4)	1.6
	Current	.NET Core 1.1	1.1.2	1.6
	Preview	.NET Core 2.0	2.0-preview (VS2017.3)	2.0
ASP.NET Core	LTS	ASP.NET Core 1.0	1.0.4	n/a
	Current	ASP.NET Core 1.1 (.NET Core 1.1, .NET 4.6)	1.1.2
	Preview	ASP.NET Core 2.0 (.NET Core 2.0, .NET Standard 2.0予定)	2.0-preview
ASP.NET MVC Core	LTS	ASP.NET Core 1.0	1.0.3	n/a
	Current	ASP.NET MVC Core 1.1	1.1.3
	Preview	ASP.NET MVC Core 2.0	2.0.0-preview
.NET Framework	-	.NET Framework 4.5	4.5.2	1.2
	-	.NET Framework 4.6	4.6.2	1.5(w/Tooling 1.0 or 2.0), 1.6(w/Tooling 2.0), 2.0
	Current	.NET Framework 4.7	4.7	1.5, 1.6, 2.0

ASP.NET Core/ASP.NET MVC Coreはランタイムではないので.NET Standardには関係ありません。

インストールするときに微妙に混乱することのあった点として.NET Core SDKバージョンやToolingといったものがあるということでしょうか。特にSDKバージョンは.NET Coreのバージョンと一致していないのでわかりにくいです。

.NETとASP.NET Coreのバージョン選択

.NET Coreは最新版を素直に使えば良いので1.1シリーズでよいでしょう。

.NET Frameworkは4.7が最新なのですがSystem.ValueTupleがコアライブラリ入りしたおかげで、.NET Standardなライブラリ側でSystem.ValueTupleパッケージのNuGet参照があると参照が混乱して無事死亡というひどい問題があるので4.7を選ぶときには気を付けましょう。

ASP.NET Core/ASP.NET MVC Coreは最新で良さそうです。

.NET Coreは.NET Core 1.1(.2) + ASP.NET Core 1.1(.2) + ASP.NET MVC Core 1.1(.3)
.NET Frameworkは.NET 4.6.2 + ASP.NET Core 1.1(.2) + ASP.NET MVC Core 1.1(.3)
- .NET Framework 4.7はSystem.ValueTupleの参照の扱いが要注意

.NET Standardの選択

.NET Coreをターゲットにする分に関してはまあ1.0-1.6どれでもという感じです。

.NET Frameworkがややこしく.NET Framework 4.6で.NET Standardは1.6にするにはTooling 2.0である必要がある、ということです。そもそもTooling 1.0/2.0とはという話になって訳が分からないので1.5以下を選ぶのが無難そうです。

なお.NET Standard 1.5は.NET Framework 4.6.2以降なので気を付けないと.NET Framework 4.6がターゲットにならないものになります。1.4でも4.6.1ですけど…。ややこしい。

そういった点を鑑みると以下のような感じで選ぶのがよさそうかなと思いました。

.NET Coreのみをターゲットにするなら.NET Standard 1.6
.NET Framework 4.6/.NET Core/Xamarin/UWPをカバーするなら.NET Standard 1.3
- .NET Framework 4.6.1以降なら1.4
- .NET Framework 4.6.2以降なら1.5
.NET Standard 2.0がでたら.NET 4.6.2/.NET Core 2.0(他はそのまま)に引き上げつつ.NET Standard 2.0へ移行

もちろん使いたいものによって選択するものは変わってくると思います。古いランタイムをターゲットにしている場合にはPCLやShared Projectで#ifの方が良かったりするかもしれません(Unityとか)。

まとめ

.NET Standard 2.0はよ。

LINQPadのコードにファイルをドラッグアンドドロップで渡したい

Created at: 2017-05-20 00:00:00Z

LINQPadでちょっとしたツールやバッチスクリプト的なものを作ったときに処理対象のとしてファイルを取ることはよくあるのですが、大抵はコードにパスを直接書いていることがほとんどではないでしょうか。

ただ便利なものは往々にして対象ファイルを変えたりしたいとか誰かに渡したいこともあり、そんな時処理対象のファイルをドラッグアンドドロップでコードに渡せれば…と思ったりすることもあります。残念ながらLINQPadに標準で備わっているユーザー入力と言えば Console.ReadLine や Hyperlinq ぐらいでドロップを受け付けるユーティリティは備わっていません。

その時点で普通のWindowsアプリケーションとして作りましょうという気もするのですがそうはいってもめんどくさいですよね。というわけでなんとか渡せるようにする方法です。

解決策

LINQPadは通常出力をHTMLベースで行っていますが、自力でHTML以外のカスタム出力結果パネルを出すこともできます。カスタムな出力結果パネルはWindows FormsやWPFのコントロールをホストできるというものなので、それを利用して通常のWindowsのアプリケーションと同様にドラッグアンドドロップを受け付けるという形でドロップターゲット機能を実現できます。

というわけで以下のようなメソッドを用意することでドロップ用のパネルを表示し、ドロップしたファイルのパスを返せます。

// PresentationFramework.dll と PresentationCore.dll を References に追加しておきます
Task<string[]> WaitForFileDrop()
{
    var tcs = new TaskCompletionSource<string[]>();
    var running = Util.KeepRunning();
    var button = new System.Windows.Controls.Button
    {
        Content = "Drop Here",
        AllowDrop = true,
    };
    var outputPanel = PanelManager.DisplayWpfElement(button, "File Drop");
    button.DragEnter += (sender, e) =>
    {
        e.Effects = System.Windows.DragDropEffects.Copy;
    };
    button.Drop += (sender, e) =>
    {
        var dropPaths = e.Data.GetData(System.Windows.DataFormats.FileDrop) as string[];

        running.Dispose();
        outputPanel.Close();

        tcs.SetResult(dropPaths);
    };

    return tcs.Task;
}

やっていることは単純でドロップを受け付けるボタンを作り、出力パネルとして表示し、ドロップされたらパスを取り出して TaskCompilationSource<T> を通して呼びもとに返すだけです。

使い方はこんな感じです。必要に応じてMyExtensionsなどに収めておくと使い勝手がいいでしょう。

async Task Main()
{
    // ドロップを待ち受け
    var paths = await WaitForFileDrop();

    // ドロップされたファイルのパスを出力
    paths.Dump();

    // ドロップされたファイルを画像として表示
    paths.Select(x => Util.Image(x)).Dump();
}

これで人に渡したりバッチ的に使うときにちょっと便利に使えるようになるかもしれません。どうぞご利用ください。

SharePoint Online/OneDrive for Businessでファイル名に特殊記号(%, #)を使えるようにする

Created at: 2017-04-23 13:55:00Z

今までSharePoint OnlineとOneDrive for Businessではファイル名やフォルダ名に " # % * : < > ? / \ | といった文字を利用できませんでした。そもそも大なり小なりやスラッシュ、バックスラッシュといったものはWindows上でファイル名として扱えないので困らないのですが#や%を扱えないのはかなり不便です。

例えばC#という単語が含まれているファイルをアップロードしようとするとエラーになる、と言うだけで充分すぎるといってもいいほど不便なのが理解いただけると思います。

そんな不便も随分と前からUser Voiceで上がっていて、去年にはステータスがイマヤッテルヨー(working on it)となっていたのですが、ついに今月ロールアウトされました。ヤッタネー!

# と % のサポートが有効かどうか

既存のテナントは# and % support is not enabled by defaultとあるようにデフォルトでは有効ではありません。有効にするには後述するPowerShellコマンドで設定をオプトインする必要があります。

ただし6月以降に作成された新しいテナントではenabled by defaultつまりデフォルトで有効となります。

それとは別に既存のテナントも2017年の9月までに有効にするかどうかの設定をオプトインする必要があります。特に何もしなかった場合2017年度後半(つまり来年1月以降)にデフォルト有効になります。(September 2017までにオプトインしてH2 2017以降enabled by defaultなので多分H2は会計年度)。

# と % のサポートを有効にする

というわけで明示的に有効にする必要があることが分かったので有効にしてみます。具体的にはPowerShellによる管理コマンドで設定を変えるということを行います。サイトの方からは変更できないので注意が必要です。

PowerShellで管理するにはSharePoint Online Management Shell の16.0.6323.1200以降が必要なのでインストールされていない場合や古い場合には新しくインストールします。

モジュールをインストールできたら、まず初めにSharePoint Onlineに接続します。

Import-Module Microsoft.Online.SharePoint.PowerShell
Connect-SPOService -Url https://<TenantId>-admin.sharepoint.com -Credential <UserName>@<TenantId>.onmicrosoft.com

接続ができたら、現在のテナントの設定を取得します。設定を取得するにはGet-SPOTenantコマンドを利用します。

Get-SPOTenant

このコマンドを実行した結果にSpecialCharactersStateInFileFolderNames: NoPreferenceという項目があればそのテナントは設定可能となっているということです。もしかするとまだ機能が展開中でそのテナントに導入されていない場合には出てこないかもしれません。

項目があることを確認したらSet-SPOTenantコマンドで設定します。

SpecialCharactersStateInFileFolderNamesにはAllowed(許可)またはNotAllowed(不許可)のどちらかを指定できます。NoPreference(未設定)は設定できないので注意が必要です。

Set-SPOTenant -SpecialCharactersStateInFileFolderNames Allowed

これで再度Get-SPOTenant設定できたことを確認できれば完了です。

注意

設定後、すぐに利用できるわけではないようでしばらく待つ必要があります。どのぐらいの時間がかかるのかはわかりませんが気長に待つとよいと思います。手元では半日ぐらい待って使えましたが、もっと短いかもしれないし長いかもしれません。

また、既存のアプリケーションがこの挙動(今まで含まれるはずではなかった文字が含まれること)を理解していないと壊れることがあるというような感じの話が上記リンクにありますので自社やサードパーティーの何かを使っている場合には気を付けてください。

有効になったら

# や % が含まれるファイル名やフォルダ名を作成したりアップロードできるようになります。