English log translate by ChatGPT
-
完成了GPT依据背诵的十个单词生成一篇小短文的页面（目前仅前端实现）
-
修改了关于页面的信息
-
准备开摆
（有一说一我觉得我审美不错）
- 解决了Advanced Installer的打包问题，IIS自动部署问题，数据库连接问题
- 为背单词界面和复习单词界面新增单词自动发音功能
- 优化了背单词的逻辑，但是还是有点bug
鸽了好久，完蛋力
- 登录系统提示实现
- 了解了一下WebApi的IIS发布，笔记懒得写
这里有一个关于配置环境的问题，我还是记录一下：
我在发布WebApi的时候，配置IIS后，发现IIS内的所有功能都无法使用，提示如下:
而后发现是环境配置的问题，注意一下以下三个运行时是否安装
- 对应dotnet版本的sdk
- AspNetCoreModuleV2（具体情况视webconfig内容而定，webconfig可以用VS打开）
- HostingBundle
安装位置在这
https://dotnet.microsoft.com/download/dotnet-core
上述所有运行时都可在此处找到
- 尝试跟着做了一套登录，对于流程有了一点点的熟悉，但还是完全搞不懂（也没有搞懂的必要），实现了就行，管他丫的
- 完成了登录系统的UI显示
- 尝试了一下WebApi的配置，包括UnitOfWork,AutoMapper等等，搞不懂，不过有一点就是，Dto实体和传输层的命名一致很重要，不然会有莫名其妙的错误（无法正确转换所致）
完成了以下内容
- 复习日期显示
- 单词复习完毕提示
- 今日复习完成提示
- 生词本更多内容
完成了以下内容
- 复习功能
- 复习词汇保存
- 艾宾浩斯记忆曲线（大部分）
本模块待完成
- 下次复习日期显示
- 完全记忆完成提示
- 遗忘时Combo清零
完成了以下内容
- 生词本保存
- 待学习单词保存
- 生词本与单词书记忆对接（即单词书会受到生词本影响）
本模块待完成：
- 复习词汇保存
- 复习词汇功能
- 记忆周期
完成了以下内容
- 生词本功能，目前在首页点击Toggle标记可以将单词添加到生词本当中
- 生词本界面
xaml不支持索引器计算，
也就是说，不能使用
{Binding Word[Rank].headWord}这样的语句
在WordBook的namespace下，我定义了一个NewWordBook公共类，作为存储生词的介质，如下：
namespace SFY_Word_Book.WordBook
{
public class NewWordBook:BindableBase
{
public NewWordBook() { }
public static List<WordRoot.Root> NewWords { get; set; } = new List<WordRoot.Root>();
}
}当用户在单词卡上进行标记时，单词便会完成向类中NewWords属性的迁移。
我希望有一个用户控件能够显示用户所有的生词信息，所以我建立了一个NewWordBookView以及其NewWordBookViewModel，Model如下：
public NewWordBookViewModel()
{
NewWords = new ObservableCollection<WordRoot.Root>();
foreach(var word in NewWordBook.NewWords)
{
NewWords.Add(word);
}
}
private ObservableCollection<WordRoot.Root> newWords;
/// <summary>
/// 单词集合
/// </summary>
public ObservableCollection<WordRoot.Root> NewWords
{
get { return newWords; }
set { newWords = value; RaisePropertyChanged(); }
}这里略去xaml中简单的数据绑定。
不过一个问题，那就是当NewWordBookView被首次创建时，其中能够正确显示用户添加的单词，但是如果如果用户在首次打开NewWordBookView后继续添加单词，NewWordBookView并不会随之更新。
这可不好，于是，我学习了一下如何进行订阅更新。
订阅更新是Prism框架下的一个特色，Prism框架提供了一个新的泛型集合取代LINQ的List，即为ObservableCollection,在ObservableCollection下提供了CollectionChanged事件属性进行订阅更新，下面介绍一下如何使用。
首先是将NewWordBook的
public static List<WordRoot.Root> NewWords { get; set; } = new List<WordRoot.Root>();替换为
public static ObservableCollection<WordRoot.Root> NewWords { get; set; } = new ObservableCollection<WordRoot.Root>();而后在NewWordBookViewModel中添加如下方法
private void OnNewWordBookCollectionChanged(object sendet, NotifyCollectionChangedEventArgs e)
{
//当事件端有数据增加
if (e.Action == NotifyCollectionChangedAction.Add)
{
//这里跟着增加
foreach (var item in e.NewItems)
{
NewWords.Add((WordRoot.Root)item);
}
}
//如果有减少
else if (e.Action == NotifyCollectionChangedAction.Remove)
{
//跟着减少
foreach(var item in e.OldItems)
{
NewWords.Remove((WordRoot.Root)item);
}
}
//其他的变更如出一辙
}而后在构造函数中进行绑定
NewWordBook.NewWords.CollectionChanged += OnNewWordBookCollectionChanged;则完成了订阅更新
完成了以下内容：
- 每NumOfGroup一组的单词记忆模式（默认为10）
- 单词模糊查找
在今天的码中，我利用ComboBox实现了简单的单词模糊查找效果，接下来进行总结：
首先，一个基本的ComboBox的xaml如下(样式基于MaterialDesign)：
<ComboBox
materialDesign:HintAssist.Hint="Search for unknown word"
materialDesign:TextFieldAssist.HasClearButton="True"
IsEditable="True"
Style="{StaticResource MaterialDesignComboBox}">
<ComboBox.SelectedItem>
<Binding
Mode="TwoWay"
Path="SelectedValidationFilled"
UpdateSourceTrigger="PropertyChanged" />
</ComboBox.SelectedItem>
</ComboBox>设置了其可编辑IsEditable="True",搜索框内容填充materialDesign:HintAssist.Hint="Search for unknown word",这都是基础操作，没什么好讲的。
本项目中，我想要实现输入单词（的一部分），实现搜索单词效果。这需要在ComboBox中，指定其数据来源，特性标签如下：
ItemsSource="{Binding YourDataSource}"YourDataSource是我们在Model下定义的List属性。为填充内容的集合。也就是这样声明
public List<int/string/double> YourDataSource { get; set; }完成YourDataSource的初始化和数据载入后，绑定就做好了。
那如果我的YourDataSource是一个类的集合怎么办？我想绑定类中的某个元素怎么办？
很好，假设我们的YourDataSource长这样
public class YourDataSourceClass
{
public int Rank{get;set;}
public string Name{get;set};
}我们只想绑定其Name，那么，我们可以在ComboBox中添加这一行特性
DisplayMemberPath="Name"完事
在以上的基础上，如果我想选择我搜索的内容后，接着实现xxxxx怎么办？
这就需要绑定元素的某个属性了，在以上的例子中，我们既可以绑定Rank，也可以绑定Name用来把元素的数据传出去。我们以Rank举例
我们可以在ComboBox中添加以下特性标签
SelectedValuePath="Rank"
SelectedValue="{Binding SelectedRank}"
暂时放弃了C语言后台的写法，暂时纯用C#代替实现，等以后再尝试（
完成了以下内容
- 导入CET6.json词汇
- 学习单词界面的部分UI效果实现
)
在写前台界面的时候，需要按下“认识”或者“不认识”按钮后将二者隐藏，但是在MVVM的模式下，需要进行额外的处理，怎么做呢？
这里就不踢按钮绑定命令Command的基本操作了，单纯来讲Visibility这个属性
这个属性有三个枚举值，分别为：
- Visible
- Hidden
- Collasp
三个值的特点此处不表，重点是要进行绑定操作。
对于一个控件，类似如下
<YourControl Visibility = "Visible"/>为了实现绑定，我们这样改
<YourControl Visibility = "{Binding IsShow , Converter = {StaticResource BooleanToVisibilityConverter}}"/>可以看到，绑定了一个ViewModel（Prism框架下的业务分离）下的IsHidden属性，同时用了一个布尔转可视性的转换器。
对于IsHidden属性，我们需要在ViewModel下这样定义：
private bool isShow;
public bool IsShow
{
get{return isShow;}
set{SetProperty(ref isShow, value);}
}//记得在构造函数中初始化除此之外，在Command调用的函数中，需要这样写：
public void Show()
{
//略去其他代码
IsShow = false;
OnPropertyChanged(new PropertyChangedEventArgs(nameof(IsShow)));
}这样在调用Command（调用函数时）,就能改变某个绑定了IsShow属性的控件的Visibility了。
完成了C语言后台部分的内容，包括
- 单词结构体
- 例句结构体
- 释义结构体
- 链表创建函数
- 增删改查
在CS端
-
Extension下新增公共类CSolve，
-
引用C语言封装dll
-
进行局部调用（也就是还没做完，而且没进行测试）
首先完成CSolve.c文件后，在头文件中创建CSolve.h(同名文件)，并在CSolve.c中进行如下引用
#include"CSolve.h"而后在CSolve.h中将函数进行引用，并添加修饰
extern _declspec(dllexport) struct _Word* _CreateWordListHead();修饰词为
extern _declspec(dllexport)这样就可以完成dll导出。
注意，变量尽量用下划线进行前修饰或者后修饰，和C#区分开来，这样可以明确哪些是内部的，哪些是外来的。
- 在VS中要关闭预编译头
- 要在项目属性中将项目类型转成dll
完成上述步骤之后，重新生成解决方案，就可以得到动态链接库源文件了。
-
将动态链接库文件放入CS项目的运行环境中，也就是/bin/Debug/.net7-windows
-
创建专门的管理类，我这里创建了一个CSolve类在Extension下，与PrismManager.cs平行
-
使用DLLImport标记进行导入，示例如下：
[DllImport("CSloves.dll", EntryPoint = "_CreateWordBooks")] public static extern void _CreateWordBooks();
记得用EntryPoint指示入口函数
基本操作模式只能应付最简单的处理函数，但是动态链接库中的很多函数有指针变量，结构体嵌套等等，这些都需要更多的知识进行特殊处理。
对于动态链接库中定义好的结构体，我们需要在C#中重新再对等声明一遍，否则无法调用对应函数。但是由于C语言与C++的结构体声明是顺序的（从上至下，如果一个名为a_struct的结构体放在了最末端，那么前面的结构体和函数无法调用这个名为a_struct的结构体），所以在C#中，我们同样需要声明结构体是顺序放置的，如下示例
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential)]
public struct Sentence
{
}在C语言中，为了更方便地实现字符串功能，我在结构体中用char* 指针进行了字符串定义，类似如下
struct Sentence
{
/// <summary>
/// 单词内容
/// </summary>
char* _sentenceContent;
};虽然C#可以在unsafe修饰下使用指针变量，但是都用C#了，谁还翻指针啊XD。
如果想在C#中不使用指针的情况下引用动态链接库的char* ，则需要用点新玩意了。
对于上述示例中的 _sentenceContent ，我们可以在C#的同等结构体中用IntPtr来进行定义
public IntPtr _sentenceContent; 仅是如此还不够，在调用函数或者生成方法时，需要对char* 进行发送和接受，而C#中接受char* 的方式我试了很多，只有一个是正常的，其他全部都会输出乱码，接下来对接受方式进行介绍。
假设我们有一个函数为(只是举个例子，实际代码并不是这样)
struct _Sentence* _CreateSentenceInstance(char* _sentenceContent){}那么我们可以在之前的结构体中，进行一定程度的封装
struct Sentence
{
/// <summary>
/// 单词内容
/// </summary>
private IntPtr _sentenceContent;
public string SentenceContent
{
get{return Marshal.PtrToStringUTF8(_sentenceContent); }
}
};这个过程中，我们将_sentenceContent数据成员隐藏了起来，取而代之的是string类型的SentenceContent属性，并且在返回上用了Marshal.PtrToStringUTF8()进行转化。
这个步骤是将IntPtr类型的_sentenceContent转化为UTF-8编码的字符串。
为什么要这么做呢，我们接着来看函数的封装
为了引用在上文给出的返回结构体指针变量的*_CreateSentenceInstance*函数，我们在C#中应该进行如下导入：
[DllImport("CSolves.dll", EntryPoint = "_CreateSentenceInstance", CallingConvention = CallingConvention.Cdecl)]
private static extern IntPtr _CreateSentenceInstance(byte[] _sentenceContent);不难发现，对于C语言中的char* ，在C#中，我们使用了byte[]数组来进行接收，这是因为char*的本质是一串连续地址，所以我们可以将我们需要传入的字符串转换为二进制的byte数组，也就是指定了其地址，再传入动态链接库当中。（应该是这么理解，吧）
进而，我们可以进一步对_CreateSentenceInstance进行封装，返回一个Struct
/// <summary>
/// 创建例句结构体实例
/// </summary>
/// <param name="sentenceContent"></param>
/// <returns>Sentence Struct</returns>
public static Sentence SentenceCreate(string sentenceContent)
{
byte[] _sentenceContentByte = Encoding.UTF8.GetBytes(sentenceContent);
IntPtr sentencePtr = _CreateSentenceInstance(_sentenceContentByte);
Sentence sentence = Marshal.PtrToStructure<Sentence>(sentencePtr);
return sentence;
}这里进行了三个步骤
- 将C#端传入的string使用
Encoding.UTF8.GetBytes()方法转化为二进制数组 - 调用
_CreateSentenceInstance方法，将byte[]传入，动态链接库端自动完成byte-》char* 的对接专化 - 使用
Marshal.PtrToStructure方法完成指针的结构体化转化
这样的封装方式更适合C#的调用
- 稍微做了一下背单词的UI界面，不过有待改进
- 对WebAPI进行了相关配置
- 创建了单词数据库，利用的是SQLite，不过不太明白要怎么实现增删查改，以及如何对接C语言
- 为个性化板块添加了打开动画效果
- 实现了主窗口的任务条的导航功能
- 任务条显示问题（各种容器还是没有整明白）
- 窗口预加载
- 主窗口显示问题
我依据之前的Prism依赖注入导航方法尝试着让任务栏的按钮能够导航到对应的用户控件，导航确实是实现了，但是主用户控件和新用户控件出现了重叠问题，这实在是让人火大。
后来我发现是region的问题。
之前我在MainView下定义了一个region，通过这个region实现了菜单栏导航到各个页面。
<ContentControl prism:RegionManager.RegionName="{x:Static extensions:PrismManager.MainViewRegionName}" />
而后我依葫芦画瓢，在HomeView下这样定义
<ContentControl prism:RegionManager.RegionName="{x:Static extensions:PrismManager.HomeViewRegionName}" />
在HomeViewModel中，这样写方法:
private void Navigate(TaskBar taskBar)
{
if (taskBar == null || string.IsNullOrWhiteSpace(taskBar.NameSpace))
{
return;
}
regionManage.Regions[PrismManager.HomeViewRegion].RequestNavigate(taskBar.NameSpace);
}这就导致了用户控件重叠问题。而后我尝试将HomeView.xaml中的区域注册删除（其实删不删无所谓），将导航方法中的
regionManage.Regions[PrismManager.HomeViewRegion].RequestNavigate(taskBar.NameSpace);改写为
regionManage.Regions[PrismManager.MainViewRegionName].RequestNavigate(taskBar.NameSpace);则成功解决了用户控件重叠问题。
这是因为MainView中注册的region是整个页面的region，区域为整个窗体，加载的所有的用户控件在窗体上显示。窗体本身没有东西，是空的。而HomeView中注册的region则区域为HomeView本身，在HomeViewRegion中加载的用户控件则自然会加载到HomeView上——这就导致了重叠。 用GPT的话说就是： 
一个小坑。记一下。
- 新增设置面板
- 添加个性化功能
- 修复了圆角窗口的细节
以及
- 大部分实现了每日文章的功能，调用的是API，显示图片，标题，内容信息（还有很多bug等待明天和后天去修复）
- 圆角图片的实现
- 文本长度的控制
- 三大键位置
- ItemTmplate造成的填充不满问题（原因未知，还要学）
- API调用
为了实现自动从网上获取每日资讯，我找到了一个API（只有500次token）。 我定义了一个DailyPage类在Model中（实际上叫DailyArticle更合适），包括以下几个属性（Property）
- Image 图片
- Title 标题
- Content 内容
- Flow 源地址（应该叫url更合适）
而后在HomeView当中，进行通知更新声明
//每日文章通知更新
private ObservableCollection<DailyPage> dailyPages;
public ObservableCollection<DailyPage> DailyPages
{
get { return dailyPages; }
set { dailyPages = value; RaisePropertyChanged(); }
}为了调用API，建立了异步方法：
async void CreateDailyPage(){}在其中，用如下代码体获取API-JSON信息
using (HttpClient client = new HttpClient())
{
HttpResponseMessage responseMessage = await client.GetAsync(apiUrlString);
if (responseMessage.IsSuccessStatusCode)
{
string responseContent = await responseMessage.Content.ReadAsStringAsync();
//解析Json
JObject jsonResponse = JObject.Parse(responseContent);
JArray articles = (JArray)jsonResponse["data"];
}
}解析Json的类库CSharp并不自备，需要用Nuget引入，名为NewtonSoft.Json。这样就能用上面的方法体了。
由于我的Json是个数据集合，所以需要
JArray articles = (JArray)jsonResponse["data"];对data进行拆分。而后我写下了以下方法体
foreach (JToken article in articles)
{
if (articles.Count > 0)
{
string content = (string)article["description"];
if (content.Length > 500)
{
content = content.Substring(0, 500) + "...";
}
string image = (string)article["image"];
if (image == null || image.Contains('%') || image.Contains('&') || image.Contains('$'))
{
continue;
}
if (content.Length < 50)
{
continue;
}
DailyPages.Add(new DailyPage
{
Image = (string)article["image"],
Title = (string)article["title"],
Content = content,
Flow = (string)article["url"]
});
break;
}
}之所以要用到一个循环，是为了避免出现以下情况：
- 图片乱码无法加载
- 图片被加密过
- 文字太多
- 文字太少
这里面添加了实例化方法，即如下所示：
DailyPages.Add(new DailyPage
{
Image = (string)article["image"],
Title = (string)article["title"],
Content = content,
Flow = (string)article["url"]
}); 请注意这个语法
Image = (string)article["image"]这是很重要的Json解析语法，即将Json中的"image"标注数据专化为字符串赋值给属性当中。
- 完成了首页的UI
- 将窗口替换为圆角
- 遇到了有关MetarialDesign的Style的一大堆坑，艹！！！！
- 用户在左侧菜单栏选中菜单的元素后导航至对应页面。
- 导航后收起左侧菜单栏。
- 允许用户使用导航条上的“—>”和“<—”键完成上一步和下一步的导航（利用导航日志实现）
- 需要使用“UserControl”来创建子页面，而不能用Window进行创建。
- 命名规范上，Views文件夹下的页面要命名为xxxView，ViewModel文件夹下的页面需要命名为xxxViewModel
- 创建页面后，一定一定要去App.xaml.cs下进行注册，否则无法完成导航工作！！！
( 0 )创建子页面( UserControl )于View下，同时创建其对应的Model
( 1 ). 一定要在App.xaml.cs下的重写”RegisterTypes“方法中注册创建的子页面（UserControl）,示例代码如下：
containerRegistry.RegisterForNavigation<HomeView,HomeViewModel> ();泛型中分别填入”HomeView“和其对应的”HomeViewModel“进行自动关联，这是Prism框架的一个特性。
( 2 ). 在MainView.xaml下，注册主页区域。只有注册完毕才能进行下一步导航的具体操作。 主页区域注册xaml代码如下：
<ContentControl prism:RegionManager.RegionName="{x:Static extensions:PrismManager.MainViewRegionName}" />注意到”PrismManager.MainViewRegionName“这段声明，这个需要我们自己去声明，声明过程为：
I：创建Extensions文件夹。 II:在其中创建PrismManager.cs，并且声明为”public“。在其下创建一个只读字符串，名为MainViewRegionName，其内容为MainViewRegion，这个命名格式应该是必要的。 III:在MainView.xaml下声明extension命名空间，举例如下：
xmlns:extensions="clr-namespace:SFY_Word_Book.Extensions"。IV:而后注册区域，如上。
( 3 ).在MainViewModel下创建只读的IRegionManager接口的变量regionManager
private readonly IRegionManager regionManager;并在构造函数中进行实例化，如下：
this.regionManager = regionManager;至此，区域注册完毕，接下来实现菜单导航
( 1 ).确定自己有CreateMenuBar这个方法，里面有类似于这样的构建菜单元素语句
MenuBars.Add(new MenuBar() { Icon = "Home", Title = "首页", NameSpace = "HomeView" });这段代码绑定的是MemuBar类，类下有Icon，Title和NameSpace三个属性，其中的NameSpace要和子页面名称一致（与在App.xaml.cs中注册的类一致）
( 2 ).确保有如下菜单更新代码
//菜单在主页的声明和更新
private ObservableCollection<MenuBar> menuBars;
public ObservableCollection<MenuBar> MenuBars
{
get { return menuBars; }
set { menuBars = value; RaisePropertyChanged(); }
}( 3 ).声明导航委托,泛型类型为MenuBar
public DelegateCommand<MenuBar> NavigateCommand { get; private set; }( 4 ).构造导航方法Navigate，传入MenuBar类型的menuBar，注意，若其为空或者命名空间未声明则需返回。
而后转至xaml中完成实现
( 5 ).在MainView.xaml中，查看菜单体的ListBox是否有声明其名称，例如x:Name = “MenuBar”
( 6 ).完成交互行为触发器，如下
<behaviors:Interaction.Triggers>
<behaviors:EventTrigger EventName="SelectionChanged">
<behaviors:InvokeCommandAction Command="{Binding NavigateCommand}"
CommandParameter="{Binding ElementName=MenuBar,
Path=SelectedItem}" />
</behaviors:EventTrigger>
</behaviors:Interaction.Triggers>这一步需要引入微软的behavior，即声明命名空间
xmlns:behaviors="http://schemas.microsoft.com/xaml/behaviors"至此，菜单功能完成实现
需要用到导航日志
( 1 ).声明导航日志
private IRegionNavigationJournal journal;( 2 )在Navigate方法中引用
regionManager.Regions[PrismManager.MainViewRegionName].RequestNavigate(menuBar.NameSpace, back =>
{
journal = back.Context.NavigationService.Journal;
});( 3 )声明委托指令属性
public DelegateCommand GoBackCommand { get; private set; }
public DelegateCommand GoForwardCommand { get; private set; }( 4 )实现功能，例如
GoBackCommand = new DelegateCommand(() =>
{
if (journal != null && journal.CanGoBack)
{
journal.GoBack();
}
});( 5 )确保上下键绑定的指令名称与MainViewModel.cs下的委托指令属性名称一致。
至此实现前进与返回