自定義一個文件格式,如 .jgrass
,如何將這種文件格式與對應的程序關聯起來?
或者,自己編寫了一個可以打開 txt
格式的應用程序,怎么能夠通過雙擊 txt
文件,直接打開這個自定義程序?
基本思路是向注冊表中寫入或修改一些值。
具體可以參見:
如何為你的 Windows 應用程序關聯一種或多種文件類型 - walterlv
注冊表中的文件擴展名
注冊表中的關聯程序
舉個栗子
e.g. 怎么修改 txt
文件的默認打開格式?
理論上講,有兩種實現方式。
1 修改上圖 1 中的 .txt
項的默認值,將其修改為自定義的程序ID,然后在注冊表中添加自定義的程序ID,已經其對應的執行程序的路徑。
2 修改 txtfile
項中的默認值,直接將其路徑修改為自定義程序的路徑。
看起來 2 的修改更小,更省事。但這是有問題的。
因為 txtfile
可能不止關聯了 .txt
這一種文件格式,還關聯了很多其他的格式,直接修改 txtfile
中的值,可能會導致這些文件打不開。
txtfile
這個注冊表項,除了程序 NOTEPAD.EXE
的發布者可以修改之外,其他應用都不應該去修改它,此項是對修改封閉的。
而采用方式 1,只會影響 .txt
這一種文件格式的打開方式。在注冊表中添加自定義的程序ID,這是一種擴展開放的修改方式。
具體代碼
下面是具體代碼。
nuget 引用 (來源:nuget.org)
<PackageReference Include="Walterlv.Win32.Source" Version="0.12.2-alpha"/>
向注冊表中注冊可執行程序
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Win32;
using Walterlv.Win32;
namespace GrassDemoPark.WPF2.Tiny.RegEdit
{
/*
* [如何為你的 Windows 應用程序關聯一種或多種文件類型 - walterlv]
* (https://blog.walterlv.com/post/windows-file-type-association.html)
*/
/// <summary>
/// 向注冊表中注冊可執行程序
/// </summary>
class RegisterProgram
{
/// <summary>
/// 需要管理的執行程序的產品ID,(廠商名.應用名.版本號)
/// e.g. Microsoft.PowerShellConsole.1
/// </summary>
public string ProgramId { get; }
/// <summary>
/// 該執行程序所關聯文件的類型描述
/// e.g. Text Document
/// </summary>
public string? TypeName { get; set; }
/// <summary>
/// 該執行程序所關聯文件的類型描述
/// e.g. 一個神奇的文本文件
/// </summary>
public string? FriendlyTypeName { get; set; }
/// <summary>
/// 該執行程序所關聯文件對應的 Icon
/// </summary>
public string? DefaultIcon { get; set; }
/// <summary>
/// 是否總是顯示指定文件類型的擴展名
/// </summary>
public bool? IsAlwaysShowExt { get; set; }
/// <summary>
/// 該執行程序可執行的操作/謂詞
/// </summary>
public string? Operation { get; set; }
/// <summary>
/// 對應謂詞下,其執行的具體命令;僅在<see cref="Operation"/>有效時,此值才有效
/// </summary>
public string? Command { get; set; }
/// <summary>
/// 根據指定 ProgramId,創建 <see cref="RegisterProgram"/> 的實例。
/// </summary>
/// <param name="programId"></param>
public RegisterProgram(string programId)
{
if (string.IsNullOrWhiteSpace(programId))
{
throw new ArgumentNullException(nameof(programId));
}
ProgramId = programId;
}
/// <summary>
/// 將此文件擴展名注冊到當前用戶的注冊表中
/// </summary>
public void WriteToCurrentUser()
{
WriteToRegistry(RegistryHive.CurrentUser);
}
/// <summary>
/// 將此文件擴展名注冊到所有用戶的注冊表中。(進程需要以管理員身份運行)
/// </summary>
public void WriteToAllUser()
{
WriteToRegistry(RegistryHive.LocalMachine);
}
/// <summary>
/// 將此文件擴展名寫入到注冊表中
/// </summary>
private void WriteToRegistry(RegistryHive registryHive)
{
// 寫 默認描述
registryHive.Write32(BuildRegistryPath(ProgramId), TypeName ?? string.Empty);
// 寫 FriendlyTypeName
if (FriendlyTypeName != null && !string.IsNullOrWhiteSpace(FriendlyTypeName))
{
registryHive.Write32(BuildRegistryPath(ProgramId), "FriendlyTypeName", FriendlyTypeName);
}
// 寫 IsAlwaysShowExt
if (IsAlwaysShowExt != null)
{
registryHive.Write32(BuildRegistryPath(ProgramId), "IsAlwaysShowExt", IsAlwaysShowExt.Value ? "1" : "0");
}
// 寫 Icon
if (DefaultIcon != null && !string.IsNullOrWhiteSpace(DefaultIcon))
{
registryHive.Write32(BuildRegistryPath($"{ProgramId}\\DefaultIcon"), DefaultIcon);
}
// 寫 Command
if (Operation != null && !string.IsNullOrWhiteSpace(Operation))
{
registryHive.Write32(BuildRegistryPath($"{ProgramId}\\shell\\{Operation}\\command"), Command ?? string.Empty);
}
}
private string BuildRegistryPath(string relativePath)
{
return $"Software\\Classes\\{relativePath}";
}
}
}
向注冊表中注冊文件擴展名
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Win32;
using Walterlv.Win32;
namespace GrassDemoPark.WPF2.Tiny.RegEdit
{
/*
* [如何為你的 Windows 應用程序關聯一種或多種文件類型 - walterlv]
* (https://blog.walterlv.com/post/windows-file-type-association.html)
*/
/// <summary>
/// 向注冊表中注冊文件擴展名
/// </summary>
class RegisterFileExtension
{
/// <summary>
/// 文件后綴名(帶.)
/// </summary>
public string FileExtension { get; }
/// <summary>
/// 該后綴名所指示的文件的類型
/// e.g. text/plain
/// [MIME 類型 - HTTP | MDN](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types )
/// [Media Types](https://www.iana.org/assignments/media-types/media-types.xhtml )
/// </summary>
public string? ContentType { get; set; }
/// <summary>
/// 該后綴名所指示的文件的感知類型
/// e.g. text
/// [Perceived Types (Windows) | Microsoft Docs](https://docs.microsoft.com/en-us/previous-versions/windows/desktop/legacy/cc144150(v%3Dvs.85) )
/// </summary>
public string? PerceivedType { get; set; }
/// <summary>
/// 該后綴名所指示的文件關聯的默認應用程序的 ProgramId
/// </summary>
public string? DefaultProgramId { get; set; }
/// <summary>
/// 該后綴名所指示的文件,還可以被哪些 ProgramId 所代表的程序打開。
/// </summary>
public IList<string> OpenWithProgramIds { get; set; } = new List<string>();
/// <summary>
/// 根據指定文件擴展名,創建 <see cref="RegisterFileExtension"/> 的實例。
/// </summary>
/// <param name="fileExtension"></param>
public RegisterFileExtension(string fileExtension)
{
if (string.IsNullOrWhiteSpace(fileExtension))
{
throw new ArgumentNullException(nameof(fileExtension));
}
if (!fileExtension.StartsWith(".", StringComparison.Ordinal))
{
throw new ArgumentException(
$"{fileExtension} is not a valid file extension. it must start with \".\"",
nameof(fileExtension));
}
FileExtension = fileExtension;
}
/// <summary>
/// 將此文件擴展名注冊到當前用戶的注冊表中
/// </summary>
public void WriteToCurrentUser()
{
WriteToRegistry(RegistryHive.CurrentUser);
}
/// <summary>
/// 將此文件擴展名注冊到所有用戶的注冊表中。(進程需要以管理員身份運行)
/// </summary>
public void WriteToAllUser()
{
WriteToRegistry(RegistryHive.LocalMachine);
}
/// <summary>
/// 將此文件擴展名寫入到注冊表中
/// </summary>
private void WriteToRegistry(RegistryHive registryHive)
{
// 寫默認執行程序
registryHive.Write32(BuildRegistryPath(FileExtension), DefaultProgramId ?? string.Empty);
// 寫 ContentType
if (ContentType != null && !string.IsNullOrWhiteSpace(ContentType))
{
registryHive.Write32(BuildRegistryPath(FileExtension), "Content Type", ContentType);
}
// 寫 PerceivedType
if (PerceivedType != null && !string.IsNullOrWhiteSpace(PerceivedType))
{
registryHive.Write32(BuildRegistryPath(FileExtension), "PerceivedType", PerceivedType);
}
// 寫 OpenWithProgramIds
if (OpenWithProgramIds.Count > 0)
{
foreach (string programId in OpenWithProgramIds)
{
registryHive.Write32(BuildRegistryPath($"{FileExtension}\\OpenWithProgids"), programId, string.Empty);
}
}
}
private string BuildRegistryPath(string relativePath)
{
return $"Software\\Classes\\{relativePath}";
}
}
}