MAUI Windows应用动态加载FTP目录图片问题求助

1. 修复绝对路径加载问题 #

直接使用映射盘符（如Y:）在MAUI Windows中可能无法被正确识别，建议改用UNC路径（针对网络共享的FTP目录），或确保本地路径格式规范：

• 网络共享目录：将Y:/Images/dotnet_bot.png替换为\\FTP服务器IP或名称\Images\dotnet_bot.png
• 本地目录：使用完整Windows路径格式，比如C:\Images\dotnet_bot.png（XAML中需转义为C:\\Images\\dotnet_bot.png，或通过代码绑定传递）

另外，XAML中可显式声明FileImageSource来确保路径解析正确：

<Image>
    <Image.Source>
        <FileImageSource FilePath="\\ServerName\Images\dotnet_bot.png" />
    </Image.Source>
</Image>

2. 动态加载与列表展示 #

步骤1：定义图片数据模型 #

创建简单类存储图片路径和文件名：

public class ImageItem
{
    public string FilePath { get; set; }
    public string FileName => Path.GetFileName(FilePath);
}

步骤2：绑定图片列表到UI #

在ViewModel中创建可观察集合，用于存储FTP目录下的图片路径，TCP事件触发时扫描目录填充集合：

public ObservableCollection<ImageItem> ImageItems { get; set; } = new();

private void OnTcpEventTriggered()
{
    // 替换为你的FTP目标目录路径（UNC或本地路径）
    string ftpDir = @"\\ServerName\Images";
    if (Directory.Exists(ftpDir))
    {
        var imagePaths = Directory.GetFiles(ftpDir, "*.png")
                                 .Concat(Directory.GetFiles(ftpDir, "*.jpg"))
                                 .Concat(Directory.GetFiles(ftpDir, "*.jpeg"));
        foreach (var path in imagePaths)
        {
            ImageItems.Add(new ImageItem { FilePath = path });
        }
    }
}

用CollectionView在XAML中展示图片名称列表：

<CollectionView ItemsSource="{Binding ImageItems}"
                SelectionMode="Single"
                SelectionChanged="OnImageItemSelected">
    <CollectionView.ItemTemplate>
        <DataTemplate>
            <Label Text="{Binding FileName}"
                   Margin="10"
                   FontSize="16" />
        </DataTemplate>
    </CollectionView.ItemTemplate>
</CollectionView>

步骤3：点击列表项打开图片 #

在页面后台处理选择事件，加载选中图片到视图：

private void OnImageItemSelected(object sender, SelectionChangedEventArgs e)
{
    if (e.CurrentSelection.FirstOrDefault() is ImageItem selectedItem)
    {
        // 假设DisplayImage是页面中用于展示图片的Image控件
        DisplayImage.Source = new FileImageSource { FilePath = selectedItem.FilePath };
    }
}

3. 权限配置 #

MAUI Windows应用需要访问外部目录的权限，需在Package.appxmanifest中添加以下配置：

• 访问网络共享目录：添加Private Networks (Client & Server)权限
• 访问本地目录：添加BroadFileSystemAccess权限（该权限需在Windows设置中手动启用）

手动编辑Package.appxmanifest：

<Capabilities>
    <Capability Name="privateNetworkClientServer" />
    <uap:Capability Name="broadFileSystemAccess" />
</Capabilities>

4. 实用优化技巧 #

• 异步扫描目录：避免阻塞UI线程，改用异步方法扫描目录：

  private async Task ScanFtpDirectoryAsync()
  {
      string ftpDir = @"\\ServerName\Images";
      if (Directory.Exists(ftpDir))
      {
          var imagePaths = await Task.Run(() => 
              Directory.GetFiles(ftpDir, "*.png")
                       .Concat(Directory.GetFiles(ftpDir, "*.jpg"))
                       .Concat(Directory.GetFiles(ftpDir, "*.jpeg")));
          foreach (var path in imagePaths)
          {
              ImageItems.Add(new ImageItem { FilePath = path });
          }
      }
  }
  

• 实时监控目录：用FileSystemWatcher监听目录新增文件事件，自动更新列表：

  private void SetupDirectoryWatcher()
  {
      string ftpDir = @"\\ServerName\Images";
      var watcher = new FileSystemWatcher(ftpDir)
      {
          Filter = "*.png;*.jpg;*.jpeg",
          NotifyFilter = NotifyFilters.FileName
      };
      watcher.Created += (s, e) =>
      {
          MainThread.BeginInvokeOnMainThread(() =>
          {
              ImageItems.Add(new ImageItem { FilePath = e.FullPath });
          });
      };
      watcher.EnableRaisingEvents = true;
  }
  

• 图片性能优化：如果图片较大，可使用FFImageLoading.Maui库实现异步加载与缓存，提升页面流畅度

内容的提问来源于stack exchange，提问作者DaveR